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Advance Praise for Head First Programming 



“ Head First Programming does a great job teaching programming using an iterative process. Add a little, 
explain a little, make the program a little better. This is how programming works in the real world 
and Head First Programming makes use of that in a teaching forum. I recommend this book to anyone 
who wants to start dabbling in programming but doesn’t know where to start. I’d also recommend this 
book to anyone not necessarily new to programming, but curious about Python. It’s a great intro to 
programming in general and programming Python specifically.” 

— Jeremy Jones, Coauthor of Python for Unix and Linux System Administration 



“David Griffiths and Paul Barry have crafted the latest gem in the Head First series. Do you use a 
computer, but are tired of always using someone else’s software? Is there something you wish your 
computer would do but wasn’t programmed for? In Head First Programming , you’ll learn how to write 
code and make your computer do things your way.” 

— Bill Mietelski, Software Engineer 



u Head First Programming provides a unique approach to a complex subject. The early chapters make 
excellent use of metaphors to introduce basic programming concepts used as a foundation for the rest 
of the book. This book has everything, from web development to graphical user interfaces and game 
programming.” 

— Doug Hellmann, Senior Software Engineer, Racemi 



“A good introduction to programming using one of the best languages around, Head First Programming 
uses a unique combination of visuals, puzzles, and exercises to teach programming in a way that is 
approachable and fun.” 

— Ted Leung, Principal Software Engineer, Sun Microsystems 
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“Kathy and Bert’s Head First Java transforms the printed page into the closest thing to a GUI you’ve ever 
seen. In a wry hip manner, the authors make learning Java an engaging ‘what’re they gonna do next?’ 
experience.” 

— Warren Keuffel, Software Development Magazine 



“Beyond the engaging style that drags you forward from know-nothing into exalted Java warrior status, Head 
First Java covers a huge amount of practical matters that other texts leave as the dreaded ‘exercise for the 
reader....’ It’s clever, wry, hip and practical — there aren’t a lot of textbooks that can make that claim and live 
up to it while also teaching you about object serialization and network launch protocols.” 

— Dr. Dan Russell, Director of User Sciences and Experience Research 
IBM Almaden Research Center (and teaches Artificial Intelligence at 
Stanford University) 



“It’s fast, irreverent, fun, and engaging. Be careful — you might actually learn something!” 

— Ken Arnold, former Senior Engineer at Sun Microsystems 

Coauthor (with James Gosling, creator of Java), The Java Programming 
Language 



“I feel like a thousand pounds of books have just been lifted off of my head.” 

— Ward Cunningham, inventor of the Wiki and founder of the Hillside Group 



“Just the right tone for the geeked-out, casual-cool guru coder in all of us. The right reference for practi- 
cal development strategies — gets my brain going without having to slog through a bunch of tired, stale 
professor-speak.” 

— Travis Kalanick, Founder of Scour and Red Swoosh 
Member of the MIT TR100 



“There are books you buy, books you keep, books you keep on your desk, and thanks to O’Reilly and the 
Head First crew, there is the penultimate category, Head First books. They’re the ones that are dog-eared, 
mangled, and carried everywhere. Head First SQL is at the top of my stack. Heck, even the PDF I have 
for review is tattered and torn.” 

— Bill Sawyer, ATG Curriculum Manager, Oracle 



“This book’s admirable clarity, humor and substantial doses of clever make it the sort of book that helps 
even non-programmers think well about problem-solving.” 

— Cory Doctorow, co-editor of Boing Boing 
Author, Down and Out in the Magic Kingdom 
and Someone Comes to Town , Someone Leaves Town 
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Praise for other Head First books 



“I received the book yesterday and started to read it... and I couldn’t stop. This is definitely tres ‘cool.’ It 
is fun, but they cover a lot of ground and they are right to the point. I’m really impressed.” 

— Erich Gamma, IBM Distinguished Engineer, and co-author of Design Patterns 

“One of the funniest and smartest books on software design I’ve ever read.” 

— Aaron LaBerge, VP Technology, ESPN.com 



“What used to be a long trial and error learning process has now been reduced neatly into an engaging 
paperback.” 

— Mike Davidson, CEO, News vine, Inc. 



“Elegant design is at the core of every chapter here, each concept conveyed with equal doses of 
pragmatism and wit.” 

— Ken Goldstein, Executive Vice President, Disney Online 



“I V Head First HTML with CSS & XHTML — it teaches you everything you need to learn in a Tun coated’ 
format.” 



— Sally Applin, UI Designer and Artist 



“Usually when reading through a book or article on design patterns, I’d have to occasionally stick myself 
in the eye with something just to make sure I was paying attention. Not with this book. Odd as it may 
sound, this book makes learning about design patterns fun. 

“While other books on design patterns are saying ‘Buehler. . . Buehler. . . Buehler. . .’ this book is on the 
float belting out ‘Shake it up, baby!”’ 

— Eric Wuehler 



“I literally love this book. In fact, I kissed this book in front of my wife.” 

— Satish Kumar 
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We dedicate this book to the first person who looked at a computer 
and then asked the question, “I wonder how I make it do this... ?” 

And to those that made programming complex enough that people 
need a book like ours to learn it. 



David: To Dawn. The smartest person I know. 

Paul: This one’s dedicated to my father, Jim Barry, who, 25 years 
ago — when I needed a push — pushed me toward computing. That 
was a good push. 
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Paul ^ 




Paul Barry recently worked out that he has 
been programming for close to a quarter century, a 
fact that came as a bit of a shock. In that time, Paul 
has programmed in lots of different programming 
languages, lived and worked in two countries on two 
continents, got married, had three kids (well... his wife 
Deirdre actually had them , but Paul did play his part), 
completed a B.Sc. and M.Sc. in Computing, written 
two other books, written a bunch of technical articles 
for Linux Journal, and managed not to lose his hair... a 
situation that, sadly, may in fact be changing. 

When Paul first saw Head First HTML with CSS & 
XHTML , he loved it so much he knew immediately that 
the Head First approach would be a great way to teach 
programming. He is only too delighted, together with 
David, to create this book in an attempt to prove his 
hunch correct. 

Paul’s day job is working as a lecturer at The Institute 
of Technology, Carlow in Ireland. As part of the 
Department of Computing & Networking, Paul gets 
to spend his day exploring, learning, and teaching 
cool programming technologies, which is his idea of 
fun (and further proof that Paul probably needs to get 
out more). Paul hopes his students think the stuff he 
teaches is fun, too. 
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David Griffiths began programming at age 12, 
when he saw a documentary on the work of Seymour 
Papert. At age 15, he wrote an implementation of 
Papert’s computer language LOGO. After studying 
Pure Mathematics at University, he began writing code 
for computers and magazine articles for humans. He’s 
worked as an agile coach, a developer, and a garage 
attendant, but not in that order. He can write code in 
over 10 languages and prose in just one, and when not 
writing, coding, or coaching, he spends much of his 
spare time travelling with his lovely wife — and fellow 
Head First author — Dawn. 

Before writing Head First Programming, , he wrote another 
book called Head First Rails , which is an excellent read 
and would make a thoughtful gift for any close friend or 
family member. 

You can follow him on Twitter at: 

http : / / twitter . com/ dgrif f iths 
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trick your brain into thinking that your life depends on knowing Programming? 
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starting to code 

Finding your way 

Writing programs gives you the power to control your PC. 

Almost everyone knows how to use a computer, but few people take the next step and 
learn how to control it. If you use other people’s software, you will always be limited by 
what other people think you want to do. Write your own programs and the only limit will 
be your own imagination. Programming will make you more creative, it will make you 
think more precisely, and it will teach you to analyze and solve problems logically. 

Do you want to be programmed or be the programmer? 



Programming lets you do more 2 

So how do you run your code? 5 

Create a new program file 6 

Prepare and run your code 7 

A program is more than a list of commands 1 2 

Codeville: Your program is like a network of roads 1 3 

Branches are code intersections 14 

if/ else branches 1 5 

The Python code needs interconnecting paths 20 

Python uses indents to connect paths 2 1 

Loops let you run the same piece of code over and over again 28 

Python’s while loop 29 

Your Programming Toolbox 35 
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textual data 

Every string has its place 

Imagine trying to communicate without words. 

All programs process data, and one of the most important types of data is text. In this 
chapter, you’ll work through the basics of textual data. You’ll automatically search 
text and get back exactly what you’re looking for. Along the way, you’ll pick up key 
programming concepts such as methods and how you can use them to bend your 
data to your will. And finally, you’ll instantly power up your programs with the help of 
library code. 




Your new gig at Starbuzz Coffee 38 

Here’s the current Starbuzz code 39 

The cost is embedded in the HTML 4 1 

A string is a series of characters 4 1 

Find characters inside the text 42 

But how do you get at more than one character? 43 

The String Exposed 48 

Beans’R’Us is rewarding loyal customers 50 

Searching is complex 52 

Python data is smart 54 

Strings and numbers are different 64 

The program has overloaded the Beans’R’Us Server 67 

Time... if only you had more of it 68 

You’re already using library code 69 

Order is restored 74 

Your Programming Toolbox 7 5 
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functions 

Let's get organized 

As programs grow, the code often becomes more complex. 

And complex code can be hard to read, and even harder to maintain. One way of 
managing this complexity is to create functions. Functions are snippets of code 
that you use as needed from within your program. They allow you to separate out 
common actions, and this means that they make your code easier to read and 
easier to maintain. In this chapter, you’ll discover how a little function knowledge 
can make your coding life a whole lot easier. 



Starbuzz is out of beans! 

What does the new program need to do? 

Don’t duplicate your code... 

Reuse code with functions 
Always get things in the right order 
Return data with the return command 
Use the Web, Luke 

The function always sends the same message 

Use parameters to avoid duplicating functions 

Someone decided to mess with your code 

The rest of the program can’t see the password variable 
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de&et files mid arrays 

Sort it out 

As your programs develop, so do your data handling needs. 

And when you have lots of data to work with, using an individual variable for each piece 
of data gets really old, really quickly. So programmers employ some rather awesome 
containers (known as data structures) to help them work with lots of data. More times 
than not, all that data comes from a file stored on a hard disk. So, how can you work 
with data in your files? Turns out it’s a breeze. 




Surf’s up in Godeville 

Find the highest score in the results file 

Iterate through the file with the open, for, close pattern 

The file contains more than numbers... 

Split each line as you read it 

The split() method cuts the string 

But you need more than one top score 

Keeping track of 3 scores makes the code more comple 

An ordered list makes code much simpler 

Sorting is easier in memory 

You can’t use a separate variable for each line of data 

An array lets you manage a whole train of data 

Python gives you arrays with lists 

Sort the array before displaying the results 

Sort the scores from highest to lowest 

And the winner is...? 

You somehow forgot the surfer names 
Your Programming Toolbox 
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JicisJies and databases 

Putting data in its place 

Arrays aren’t the only show in town when it comes to data. 

Programming languages come with other data-arranging goodies too, and our 
chosen tool, Python, is no exception. In this chapter, you’ll associate values 
with names using a data structure commonly called the hash (better known as 
dictionary to Python-folk). And when it comes to working with stored data, you’ll 
read data from an external database system as well as from regular text-based 
files. All the world’s awash with data, so turn the page and start applying your ever- 
expanding programming skills to some cool data-processing tasks. 
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Who won the surfing contest? 

Associate the name with the score 

Associate a key with a value using a hash 

Iterate hash data with for 

The data isn’t sorted 

When data gets complex 

Return a data structure from a function 

Here’s your new board! 

Meanwhile, down at the studio... 

The code remains the same; it’s the function that changes 
TVN’s data is on the money! 

Your Programming Toolbox 
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modular programming 

Keeping things straight 

The code that you write will make its way into many programs. 

And, although sharing is good, you need to be careful. One programmer might take 
your code and use it in an unexpected way, while another might change it without even 
letting you know. You might want to use one function in all your programs and, over 
time, that function’s code might change to suit your needs. Smart programmers take 
advantage of modular programming techniques to keep their workload manageable. 




Head First Health Club is upgrading some systems 178 

The program needs to create a transaction file 179 

Use strings to format strings 180 
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A late night email ruins your day 187 

$50,000... for a donut?! 188 

Only the sales from your program were rejected 189 
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Your coffee bar program still uses the old format 1 9 1 

Don’t just update your copy 192 

So how do you create a module...? 193 

The transaction file is working great, too 199 

The health club has a new requirement 200 

The Starbuzz code 205 

The two discount functions have the same name 206 

Fully Qualified Names (FQNs) prevent your programs from getting confused 207 
The discounts get the customers flooding in 213 
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building a graphical user Interface 

Going all gooey 

Your coding skills are great and getting better all the time. 

It’s just a shame your programs are not that nice to look at. Displaying prompts 
and messages on a text-based console is all well and good, but it’s so 1970s, 
isn’t it? Add some green text on a black background and your retro look will be 
complete. There has to be a better way to communicate with your users than 
the console, and there is: using a graphical user interface or GUI (pronounced 
“gooey”). Sounds cool, but complex, and it can be. But, don’t fret; learning a trick or 
two will have your code all graphical in no time. Let’s get all gooey (sorry, GUI) in 
this chapter. 



Head First TVN now produces game shows 216 

pygame is cross platform 220 

pygame Exposed 229 

0... 2... 1... 9... blast off! 230 

tkinter gives you the event loop for free 234 

tkinter is packed with options 235 

The GUI works, but doesn’t do anything 238 

Connect code to your button events 239 

The GUI program’s now ready for a screentest 244 

But TVN is still not happy 246 

Label it 249 

Your Programming Toolbox 255 
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gufs and data 

Data entry widgets 

GUIs don’t just process events. They also handle data. 

Almost all GUI applications need to read user data, and choosing the right widgets can 
change your interface from data entry hell to user heaven. Widgets can accept plain 
text, or just present a menu of options. There are lots of different widgets out there, 
which means there are lots of choices, too. And, of course, making the right choice can 
make all the difference. It’s time to take your GUI program to the next level. 




Head-Ex needs a new delivery system 
They’ve already designed the interface 
Read data from the GUI 

The Entry and Text widgets let you enter text data into your GUI 

Read and write data to text fields 

Large Text fields are harder to handle 

One of the Head-Ex deliveries went astray 

Users can enter anything in the fields 

Radio buttons force users to choose a valid depot 

Creating radio buttons in tkinter 

The radio buttons should work together 

The radio buttons can share a model 

The system tells the other widgets when the model changes 
So how do you use models in tkinter? 

Head-Ex’s business is expanding 

There are too many depots on the GUI 

An OptionMenu lets you have as many options as needed 

The model stays the same 

Things are going great at Head-Ex 
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exceptions and message boxes 

Get the message? 

Sometimes things just go wrong. You just need to handle it. 

There will always be things beyond your control. Networks will fail. Files will 
disappear. Smart coders learn how to deal with those kinds of errors and make 
their programs recover gracefully. The best software keeps the user informed 
about the bad things that happen and what should be done to recover. By learning 
how to use exceptions and message boxes, you can take your software to the 
next level of reliability and quality. 



What’s that smell? 294 

Someone changed the file permissions 295 

When it couldn’t write to the file, the program threw an exception 296 
Catch the exception 297 

Watch for exceptions with try/ except 298 

There’s an issue with the exception handler 302 

A message box demands attention 303 

Creating message boxes in Python 304 

Your Programming Toolbox 311 
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graphical interface elements 

Selecting the right tool 

It’s easy to make your programs more effective for your users. 

And when it comes to GUI applications, there’s a world of difference between a working 
interface and one that’s both useful and effective. Selecting the right tool for the 
right job is a skill that comes with experience, and the best way to get that experience 
is to use the tools available to you. In this chapter, you’ll continue to expand your 
GUI application building skills. There’s a bunch of truly useful widgets waiting to be 
experienced. So, turn the page and let’s get going. 



Time to mix it up 314 

The music just kept on playing. . . 318 

Not all events are generated by button clicks 3 1 9 

Capturing the protocol event isn’t enough 326 

Two buttons, or not two buttons? That is the question... 328 

The checkbox is an on/ off, flip/ flop toggle 33 1 

Working with checkboxes in tkinter 332 

Pump up the volume! 336 

Model a slider on a scale 337 

Use pygame to set the volume 339 

Use tkinter for everything else 340 

The DJ is over the moon! 347 

Your Programming Toolbox 348 
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custom Widgets ctnd classes 

With an object in mind 

Requirements can be complex, but programs don’t have 
to be. 

By using object orientation, you can give your programs great power without 
writing lots of extra code. Keep reading, and you’ll create custom widgets that do 
exactly what you want and give you the power to take your programming skills 
to the next level. 




The DJ wants to play more than one track 

Create code for each track as a function 

The new function contains other functions 

Your new function needs to create widgets and event handlers 

The DJ is confused 

Group widgets together 

A frame widget contains other widgets 

A class is a machine for creating objects 

A class has methods that define behavior 

But how does an object call a method? 

The SoundPanel class looks a lot like the create_gui() function 
class = methods + data 
The Class Exposed 

The DJ has an entire directory of tracks 
It’s party time! 

Your Programming Toolbox 
Leaving town... 

It’s been great having you here in Codeville! 
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The Top Ten Things (we didn't cover) 




You’ve come a long way. 

But learning how to program is an activity that never stops. The more you code, the 
more you’ll need to learn new ways to do certain things. You’ll need to master new 
tools and new techniques, too. There’s just not enough room in this book to show you 
everything you might possibly need to know. So, here’s our list of the top ten things we 
didn’t cover that you might want to learn more about next. 



# 1 : Doing things “The Python Way” 386 

#2: Using Python 2 387 

#3: Other programming languages 388 

#4: Automated testing techniques 389 

#5: Debugging 390 

#6: Command-line execution 391 

#7: Ooops... we could’ve covered more OOP 392 

#8: Algorithms 393 

#9: Advanced programming topics 394 

#10: Other IDEs, shells and text editors 395 
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how to use this book 



Who is this book for? 

If you can answer “yes” to all of these: 



© 

© 

© 



Do you wish you had the know-how to control your 
computer and make it do new things? 

Do you want to learn how to program, so you can create 
the next big thing in software, make a small fortune, and 
retire to your own private island? 

Do you prefer actually doing things and applying the stuff 
you learn over listening to someone in a lecture rattle on 
for hours on end? 



OK, maybe that one’s a little 
&>v~C ettbed- M, you $°tta 
start somewhere, right? 



this book is for you. 



Who should probably back away from this book? 

If you can answer “yes” to any of these: 



© 

© 

© 



Are you a seasoned programmer? Do you already know 
how to program? 

Are you looking for a quick introduction or reference book 
to Python? 

Would you rather have your toenails pulled out by 15 
screaming monkeys than learn something new? Do you 
believe a programming book should cover everything and 
if it bores the reader to tears in the process then so much 
the better? 



this book is not for you. 



CNote ■from marketing: this book 
■S +or anyone with a dredit dard... 
well addept a dhedk, too.J 
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We know what you're thinking 



“How can this be a serious Programming book?” 
“What’s with all the graphics?” 





“Gan I actually learn it this way?” 

We know what your brain is thinking 



THIS 

,s 



This must be important! Don't forget it! 






But imagine you’re at home, or in a library It’s a safe, warm, tiger-free zone. 
You’re studying. Getting ready for an exam. Or trying to learn some tough -fW\£ 
technical topic your boss thinks will take a week, ten days at the most. 

Just one problem. Your brain’s trying to do you a big favor. It’s trying to 
make sure that this obviously non-important content doesn’t clutter up scarce 
resources. Resources that are better spent storing the really big things. 

Like tigers. Like the danger of fire. Like how you should never have 
posted those “party” photos on your Facebook page. And there’s no 
simple way to tell your brain, “Hey brain, thank you very much, but 
no matter how dull this book is, and how little I’m registering on the 
emotional Richter scale right now, I really do want you to keep this 
stuff around.” 



Your brain craves novelty. It’s always searching, scanning, waiting for something 
unusual. It was built that way, and it helps you stay alive. 

So what does your brain do with all the routine, ordinary, normal things 
you encounter? Everything it can to stop them from interfering with the 
brain’s real job — recording things that matter. It doesn’t bother saving the 
boring things; they never make it past the “this is obviously not important” 
filter. 



How does your brain know what’s important? Suppose you’re out for a day 
hike and a tiger jumps in front of you, what happens inside your head and 
body? 

Neurons fire. Emotions crank up. Chemicals surge. 

And that’s how your brain knows... 
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Metacognition: thinking about thinking 

If you really want to learn, and you want to learn more quickly and more 
deeply, pay attention to how you pay attention. Think about how you think. 
Learn how you learn. 

Most of us did not take courses on metacognition or learning theory when we 
were growing up. We were expected to learn, but rarely taught to learn. 





So just how DO you get your brain to treat 
programming like it was a hungry tiger? 

There’s the slow, tedious way, or the faster, more effective way. The 
slow way is about sheer repetition. You obviously know that you are able to learn 
and remember even the dullest of topics if you keep pounding the same thing into your 
brain. With enough repetition, your brain says, “This doesn’t feel important to him, but he 
keeps looking at the same thing over and over and over, so I suppose it must be.” 



But we assume that if you’re holding this book, you really want to learn how 
to program And you probably don’t want to spend a lot of time. If you want 
to use what you read in this book, you need to remember what you read. And 
for that, you’ve got to understand it. To get the most from this book, or any book 
or learning experience, take responsibility for your brain. Your brain on this 
content. 

The trick is to get your brain to see the new material you’re learning as 
Really Important. Crucial to your well-being. As important as a tiger. 
Otherwise, you’re in for a constant battle, with your brain doing its best to 
keep the new content from sticking. 



The faster way is to do anything that increases brain activity, especially different 
types of brain activity. The things on the previous page are a big part of the solution, 
and they’re all things that have been proven to help your brain work in your favor. For 
example, studies show that putting words within the pictures they describe (as opposed to 
somewhere else in the page, like a caption or in the body text) causes your brain to try to 
makes sense of how the words and picture relate, and this causes more neurons to fire. 
More neurons firing = more chances for your brain to get that this is something worth 
paying attention to, and possibly recording. 



A conversational style helps because people tend to pay more attention when they 
perceive that they’re in a conversation, since they’re expected to follow along and hold up 
their end. The amazing thing is, your brain doesn’t necessarily care that the “conversation” 
is between you and a book! On the other hand, if the writing style is formal and dry, your 
brain perceives it the same way you experience being lectured to while sitting in a roomful 
of passive attendees. No need to stay awake. 



But pictures and conversational style are just the beginning. . . 
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Here's what WE did: 

We used pictures , because your brain is tuned for visuals, not text. As far as your brain’s 
concerned, a picture really is worth a thousand words. And when text and pictures work 
together, we embedded the text in the pictures because your brain works more effectively 
when the text is within the thing the text refers to, as opposed to in a caption or buried in the 
text somewhere. 

We used redundancy , saying the same thing in different ways and with different media types, 
and multiple senses , to increase the chance that the content gets coded into more than one area 
of your brain. 

We used concepts and pictures in unexpected ways because your brain is tuned for novelty, 
and we used pictures and ideas with at least some emotional content , because your brain 
is tuned to pay attention to the biochemistry of emotions. That which causes you to feel 
something is more likely to be remembered, even if that feeling is nothing more than a little 

humor , surprise , or interest . 

We used a personalized, conversational style , because your brain is tuned to pay more 
attention when it believes you’re in a conversation than if it thinks you’re passively listening 
to a presentation. Your brain does this even when you’re reading. 

We included more than 80 activities , because your brain is tuned to learn and remember 
more when you do things than when you read about things. And we made the exercises 
challenging-yet-do-able, because that’s what most people prefer. 

We used multiple learning styles , because you might prefer step-by-step procedures, while 
someone else wants to understand the big picture first, and someone else just wants to see 
an example. But regardless of your own learning preference, everyone benefits from seeing the 
same content represented in multiple ways. 

We include content for both sides of your brain , because the more of your brain you 
engage, the more likely you are to learn and remember, and the longer you can stay focused. 
Since working one side of the brain often means giving the other side a chance to rest, you 
can be more productive at learning for a longer period of time. 

And we included stories and exercises that present more than one point of view , 
because your brain is tuned to learn more deeply when it’s forced to make evaluations and 
judgments. 

We included challenges , with exercises, and by asking questions that don’t always have 
a straight answer, because your brain is tuned to learn and remember when it has to work at 
something. Think about it — you can’t get your body in shape just by watching people at the 
gym. But we did our best to make sure that when you’re working hard, it’s on the right things. 
That you’re not spending one extra dendrite processing a hard-to-understand example, 
or parsing difficult, jargon-laden, or overly terse text. 

We used people. In stories, examples, pictures, etc., because, well, because you’re a person. 
And your brain pays more attention to people than it does to things. 
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Here's what YOU can do to bend 
your brain into submission 

So, we did our part. The rest is up to you. These tips are a 
starting point; listen to your brain and figure out what works 
for you and what doesn’t. Try new things. 

Cut this out dhd sti£k it 
° h yowr refrigerator. 



Q Slow down. The more you understand, the 
less you have to memorize. 

Don’t just read. Stop and think. When the book asks 
you a question, don’t just skip to the answer. Imagine 
that someone really is asking the question. The 
more deeply you force your brain to think, the better 
chance you have of learning and remembering. 

Do the exercises. Write your own notes. 

We put them in, but if we did them for you, that 
would be like having someone else do your workouts 
for you. And don’t just look at the exercises. Use a 
pencil. There’s plenty of evidence that physical 
activity while learning can increase the learning. 

Read the 'There are No Dumb Questions" 

That means all of them. They’re not optional 
sidebars, they We part of the core content! 

Don’t skip them. 

A Make this the last thing you read before bed. 
Or at least the last challenging thing. 

Part of the learning (especially the transfer to 
long-term memory) happens after you put the book 
down. Your brain needs time on its own, to do more 
processing. If you put in something new during that 
processing time, some of what you just learned will 
be lost. 

@ Talk about it. Out loud. 

Speaking activates a different part of the brain. If 
you’re trying to understand something, or increase 
your chance of remembering it later, say it out loud. 
Better still, try to explain it out loud to someone else. 
You’ll learn more quickly, and you might uncover 
ideas you hadn’t known were there when you were 
reading about it. 



Drink water. Lots of it. 

Your brain works best in a nice bath of fluid. 
Dehydration (which can happen before you ever 
feel thirsty) decreases cognitive function. 

Listen to your brain. 

Pay attention to whether your brain is getting 
overloaded. If you find yourself starting to skim 
the surface or forget what you just read, it’s time 
for a break. Once you go past a certain point, you 
won’t learn faster by trying to shove more in, and 
you might even hurt the process. 

Feel something. 

Your brain needs to know that this matters. Get 
involved with the stories. Make up your own 
captions for the photos. Groaning over a bad joke 
is still better than feeling nothing at all. 

Write a lot of code! 

There’s only one way to learn to program: writing 
a lot of code. And that’s what you’re going to 
do throughout this book. Coding is a skill, and the 
only way to get good at it is to practice. We’re going 
to give you a lot of practice: every chapter has 
exercises that pose a problem for you to solve. Don’t 
just skip over them — a lot of the learning happens 
when you solve the exercises. We included a solution 
to each exercise — don’t be afraid to peek at the 
solution if you get stuck! (It’s easy to get snagged 
on something small.) But try to solve the problem 
before you look at the solution. And definitely get it 
working before you move on to the next part of the 
book. 
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Read Me 

This is a learning experience, not a reference book. We deliberately stripped out everything 
that might get in the way of learning whatever it is we’re working on at that point in the 
book. And the first time through, you need to begin at the beginning, because the book 
makes assumptions about what you’ve already seen and learned. 



This is not Head First Python. 

We use release 3 of the Python programming language throughout this book, but this 
fact alone does not make this book Head First Python. We chose Python because it’s a great 
programming language to start with and it’s also a great programming language to grow 
with. In fact, Python might be the only programming language you’ll ever need to learn 
and use (although your employer might think otherwise). Of course, you have to start with 
something, and we can think of no better programming language to use than Python when 
first learning how to program. That said, this book isn’t designed to teach you Python; 
it’s designed to teach you programming , so most of the things we show you are designed to 
hightlight the programming concept , not the Python feature. 



You need to install Python 3 on your computer. 

To run the programs in this book, you need to download and install Python 3 on your 
computer. This isn’t as hard as it sounds. Pop on over to the Python download site and 
select the option that fits best with the computer you are using. Just be sure to select release 
3 of Python, not release 2: http://zvwzia.python.org/dozvnload. 



We begin by teaching some basic programming concepts, then we 
start putting programming to work for you right away. 

We cover the fundamentals of programming in Chapter 1 . That way, by the time you 
make it all the way to Chapter 2, you are creating programs that actually do something 
real, useful, and — gulp! — fun. We are guessing you’ll be amazed by how much you can do 
with less than a dozen lines of code in Chapter 2. The rest of the book then builds on your 
programming skills turning you from programming newbie to coding ninja master in no time. 
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The activities are NOT optional. 

The exercises and activities are not add-ons; they’re part of the core content of the book. 
Some of them are to help with memory, some are for understanding, and some will help 
you apply what you’ve learned. Don’t skip the exercises . 



The redundancy is intentional and important. 

One distinct difference in a Head First book is that we want you to really get it. And we 
want you to finish the book remembering what you’ve learned. Most reference books 
don’t have retention and recall as a goal, but this book is about learning, , so you’ll see some 
of the same concepts come up more than once. 



The examples are as lean as possible. 

Our readers tell us that it’s frustrating to wade through 200 lines of an example looking 
for the two lines they need to understand. Most examples in this book are shown within 
the smallest possible context, so that the part you’re trying to learn is clear and simple. 
Don’t expect all of the examples to be robust, or even complete — they are written 
specifically for learning, and aren’t always fully-functional. 

We’ve placed a lot of the code examples on the Web so you can copy and paste them as 
needed. You’ll find them at two locations: 



http://www.headfirstlabs.com/books/hfprog/ and 
http:/ / programming, itcarlow.ie 



The Brain Power exercises don't have answers. 

For some of them, there is no right answer, and for others, part of the learning 
experience of the Brain Power activities is for you to decide if and when your answers 
are right. In some of the Brain Power exercises, you will find hints to point you in the 
right direction. 
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The technical review team 
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Doug Hellmann is a Senior Software Engineer 
at Racemi and former Editor in Chief for Python 
Magazine. He has been programming in Python since 
version 1 .4 and prior to Python worked mostly with C 
on a variety of Unix and non-Unix platforms. He has 
worked on projects ranging from mapping to medical 
news publishing, with a little banking thrown in for 
good measure. Doug spends his spare time working on 
several open source projects; reading science fiction, 
history, and biographies; and writing the Python Module 
of the Week blog series. 

Jeremy Jones is the coauthor of Python for Unix and 
Linux System Administration and has been actively using 
Python since 2001. He has been a developer, system 
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2002 and is currently a Principal Software Engineer 
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geek for over 20 years. He’s currently a Software 
Engineer at a leading national academic medical center 
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you’ll find him at a golf course chasing a little white ball. 
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Safari® Pooks Online 



Safari 

Books Online 



When you see a Safari® icon on the cover of your favorite 
technology book that means the book is available online 
through the O’Reilly Network Safari Bookshelf 



Safari offers a solution that’s better than e-books. It’s a virtual library that lets you 
easily search thousands of top tech books, cut and paste code samples, download 
chapters, and find quick answers when you need the most accurate, current 
information. Try it for free at http : / / safari . oreilly . com. 
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1 starting t9 code 




# Finding your way 




I wish "sweet cheeks" here 
would finish with the polishing. 
I've got to re-bore the cam 
shaft and reprogram the EMS 
for Saturday's drift race. 



■ * 



Writing programs gives you the power to control your PC. 

Almost everyone knows how to use a computer, but few people take the next step and 
learn how to control it. If you use other people’s software, you will always be limited by 
what other people think you want to do. Write your own programs and the only limit will be 
your own imagination. Programming will make you more creative, it will make you think 
more precisely, and it will teach you to analyze and solve problems logically. 

Do you want to be programmed or be the programmer? 
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Programming lets you do more 

You’ve got problems to solve and work to do, but your existing software 
doesn’t quite cut it. Even with all those programs on your computer, 
you still need to do something different, something specific to you. 




You want to do more with your computer. You want to take control. 

Learning to program gives you the power to create and solve. 
Learning to program puts you in charge. 

But, how does programming work? 

Let's look at a simple game written in Python. 



Chapter 1 
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Sharpen your pencil 



This code is a guessing-game program. Study it carefully, and 
opposite each line of code in the program, write down what you 
think the code does. If you're not sure what a particular line of 
code does, don't worry, but try to guess anyway. One line has 
already been entered to get you started: 



print ( "Welcome ! " ) 
g = input ("Guess the number: ") 

guess = int (g) 
if guess == 5: 

print ( "You win ! " ) 
else : 

print ("You lose!") 
print ("Game over!") 



Corwer-fc /the mfut: bo a 



TKis Code is Wiri lie* m 
Please 3 ^ ^ p^ u 
Projvaniroihj language, which 
IS used 'throughout this book. 
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guessing games 



fi 




n your pencil 
Solution 



print ( "Welcome ! " ) 
g = input ("Guess the number: 
guess = int (g) 
if guess — 5: 

print ("You win!") 
else : 

print ("You lose!") 
print ( " Game over ! " ) 



This code is a guessing-game program. You were to write down 
what you think the code does. 

rwt worry if your answers are 
bom ours. |f t he y 

similar, then everything i s OK. ^ , , 

J .display a. welcome message. 

Ask -the user to input $ guess. 
Corwer-i -the input to. a number; 
l/Vas the guessed number e«\ual to 5? 
Tell tbe user U ybu 
Otherwise... 

tell, the user . u You lose.( w 

End the .program. 



Put what are g and guess ? 

You might be wondering what g and guess are in the code. They are 
called variables and they’re used to keep track of data in the computer’s 
memory 



,u e C Va,Ue '^ered will 

ManaWe / |, e know* as > y 

= input ( "Guess the number: 
^-^guess = int (g) 

««aW , \ 

version ot rnc ^ 

talU «-t V ss ' 




A variable is really just a label for data. So if the user inputs “3” at the 
keyboard, then guess will be set to the number 3, and whenever the 
computer reads guess, it will read it as the value 3. 




Watch it! 



Be careful with 
= signs in code. 

Programming 

languages use = 
signs for different 
purposes. In most languages 
(including Python), a double 
equals (==) is a test for equality. 
It means, “are these two things 
equal?” In contrast, a single 
equal (=) is an instruction 
(known as assignment) that 
means “set the value to.” 



4 
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So how do you run your code? 



There are two things that you will need to run the guessing-game 
program: an editor and an interpreter. 

The editor saves the code you write into a file on your hard disk. The 
code (sometimes called the source code) is just text, and it can be 
written and read by humans. 




But computers can’t process text meant for humans, at least not very well. 
That’s why we need a tool to translate the human-friendly source code 
into the binary 1 s and Os that computers do understand. That’s what an 
interpreter does. In this book, an interpreter called Python is used. 




O 

0 




■S* pgth 



Python 

'"klrpir eiey. 

i 

ion 



n-tev-yv-e-tev -translates 

ot the 

into lan<y*a$e that the 








So we need an editor and a Python interpreter. Fortunately, Python 3 
comes with a built-in application called IDLE, which does both jobs and 
more. IDLE enables you to write and edit Python code, it translates this 
code into binary form, and finally, it runs the Python 3 program. Because 
of this, IDLE is known as an Integrated Development Environment. 

Let's see these steps in action. 
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open the shell 



Create a new program file 

When you first start IDLE, it displays a window called the Python Shell. 
Select the New Window option from the Python Shell File menu, 
which creates a new edit window for you. Input your program code as text 
into this edit window and you’ll be on your way. 



This is IDLE’s v. 

Python Shell- 



Python 5 Kq]I 



pile fcdit bhe:i Ltebyg Options Windows 



Help 



JSew Window Chl+N 



Opurr. ■ ■ 

Rlm. ml fill-. 


Ctfl+Q 


Q| im t^iKlulr. 


All+M 


tiny. gniwwr 
£arh Flrfiw'ipr 


Alt+C 




ctji-psl 


flpjtfr A 1 


tLal+51 


^.ivr A j . 


Alt + fLh 


PVnnl Window 


Ctfl+P 


Close 


Alt + 1 4 


txic 


CtH+O 







L 

Do ih h! 









Feb 17 200&. 13: 13 : 37 i 
iti - ' or ■ license £ J( " lor acre inlorraat Ion l 

The Window "ep 
tveates an editxmdow. 



■u nth tod' 



Tile friit rnrmnt Run Op I inns Windows 





■s ah ID LB 

window. 



jjplp : 



print ( n Vic leone I " ) 

y = I ri£:i] l. ( “ G ^ ’ 1 se-: r: Lira ! .-h* r : 

gniese — int{g) 

LJIJ+f^HI == 3 1 

print ( " 3 f on wifll ■ } 

print [ " 'i o 11 loaol'’] 
pr i Tit ( H fin— e nvrr l " ) 



Go ahead and open a new IDLE edit 
window and type in the code from page 3. 



The Python program is dolor- 
eoded within /VLB's edit 
window. This dolor-doding 
•s referred to as "syntax 
highlighting." Be sure to enter 
the dode in EXACTLY as it 
appears here. Don't forget 
those dharadters. 



I n Q Cnl f! I 



This is how IDLE looks on our domputer^ Things 
might look a little different on yours. Dont 
worry the IDLE menu system and IDLE s 
behavior should he the same, regardless of wh.dh 
operating system you Ye usin<y 
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Prepare and run your code 



The next step is to prepare your program code for execution. To do this, 
select File — » Save from the menu to save your program code to a file. 
Choose an appropriate name for your program. 



Directory. /Documents 



Python pirojtra,* 
+ | iena** >es usually 

e »d wi-fch M .py" 1 



W. 



£ y° u choos e File s ave 

Worn ***, you Can save 
youir to&t ih a -Pile. 




Fill' Uiunt: i].uiir. \4 

FiIl-j ol lyiw, Python uind Lai I iIl-j \ .pyw.* ,lxll 




Python programs are usually saved in files that end with . py, so let’s call 
this program game . py. 



Cli£k -the Save button -to 
^ca-te and save -the -Pile. 



It doesn’t really matter to IDLE which directory you save the file in. Some 
coders like to create special directories for each new programming project. 
But for now, just save the code in some directory that’s easy to remember. 



Now, let's see what happens when we run the program. 
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test drive 




Tost DriVq 



To run the program, you need to make sure that the edit window for 
the game . py program code is selected. Each time you run (or rerun) 
the program, you need to click on the IDLE edit window and choose 
the Run Module option from the Run menu. The word module is 
a name that IDLE uses to refer to your program code. 

Here’s what happens when you run the code: 



wv* y<* your Code Wi-thir, IDLE, 
assays appea , wrtU the p thoh 

fig ho * edit window 

, E automatically makes the shell the 
Currently seledted wirdov, the msta.t 
youv program runs. 




Congratulations! The program works. 

Each time you run the code, it displays a “Welcome!” message, 
accepts input from the keyboard, and then tells us whether or not 
we guessed the right answer. That means the program is accepting 
input, it’s processing the data, and then it generates output. 
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% I've never heard of Python. Is it 
popular? 



Python is used in lots of cool places. 
Google, Industrial Light & Magic, YouTube, 
and NASA (to name a few) all use Python. 
We think they know what they're doing. 



So, when I'm done with this 
book I'll throw Python away and use 
something else, like C#or J ava? 

Only if you wantto. Python might be 
the only programming language you'll ever 
need. But, yes, if you wantto learn another 
programming language, you can take 
everything you learn about programming in 
this book and apply it to any other language 
with the minimum of effort. 



o: But a buddy of mine told me I 
should learn J ava or C#. Why are you 
not using either of these programming 
languages in this book? 

Both J ava and C#are great 
programming technologies, but they can be 
difficult to learn, especially when you are 
just starting out. This is not the case with 
Python. And, anyway, this is a book that's 
designed to teach you how to program, and 
using Python as your first programming 
language will help us to do just that. 



There seems to be many different 
versions of Python. Which should I use? 



There are two main releases of 
Python: 2 and 3. This book is based on 
release 3 of the language. Python 3 is the 
future of the language; any new features 
are guaranteed to be added to release 3 
of the language, not release 2. Of course, 
like all releases, Python 3 remains a free 
download, which makes it a no-brainer 
when decidiing if you can afford to use it. 



th&ce-iccce nQ 

Dumb Questions 



Will Python run on my phone, just 
like J ava? 

That really depends on your phone. 
Python is designed to run on lots of 
different technologies and operating 
systems. Running your own code on your 
own phone is a very specific requirement, 
and J ava has that pretty well covered at 
the moment. As a programming technology, 
J ava was initially designed to run on very 
small devices, so it is no big surprise that 
it is a strong and popular choice when it 
comes to telephony. 




Why is the Python IDE called 



It's partly because it sounds like IDE, 
but we suspect that it has more to do with 
Eric Idle, one of the founding members of 
the Monty Python's Flying Circus comedy 
group. 



Q, Come again?!? Monty Python's 
Flying what? 

Circus. Yes, we know: sounds silly, 
doesn't it? And, believe us, it is. It's funny, 
too. The creator of Python, Guido van 
Rossum, is a big Monthy Python fan and 
reportedly watched the show's reruns 
while he designed Python. You'll find lots 
of references to Monty Python folklore in 
the Python community. Dead parrots are a 
particular favorite. 




What does int(g) mean? 



It tells Python to interpret the user's 
input as a number rather than a letter. 

Within programming languages, the number 
5 is different than the letter '5'. 




So what if we'd left it out? 



The computer would have treated the 
input entered by the user of the program as 
a letter. If you ask the computer if a letter 
is equal to a number, it gets confused and 
tells you it isn't. 



% Why's that? 

Because if the computer thinks that 
two pieces of information are of different 
"types," it assumes that there's no way they 
can be equal. 



% So what if I had nottyped a 
number when I was asked fora guess? 
What if I'd just entered my name or 
something? 



The code would have crashed with an 
error. In fact, Python will complain that the 
program crashed with a "ValueError"(more 
on these error messages later in the book). 
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give a hint 



0»t 7 ouV " uSCV " s 




I don't get it. How am I 
supposed to guess the winning 
number? All the program tells 
me is that my guess is right or 
wrong. Come on, give me some 
help here! 



The program needs to do more. 

At the moment, the guessing game tells the user whether his 
guess is right or wrong, but nothing more than that. It might 
be more helpful if the program displayed more informative 
messages, such as whether the guess is higher or lower than 
the correct answer. That would help the user to hone in on the 
right answer the next time the program is run. 

We can do this by changing the code. But in what way? 



We need tW.s Y r0 V a ' n ' /*i 
{*, display messages that 
ave »»ove mtcxrmatwe- 
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r / r 



You need to decide what messages should be displayed to the 
user. Below is a table showing some typical values the user might 
enter. What do you think the message should say? 








Think about the original code. You will need to use 
more than just print ( ) commands to provide 
more informative feedback. What else will you 
need? 
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code is a highway 



< Solution 



You needed to decide what messages should be displayed to the 
user. Below is a table showing some typical values the user might 
enter. What did you think the message should say? 




A program is more than a list of commands 



You could create a program that was simply a list of commands. But you 
almost never will. This is because a simple list of commands can only be 
run in one direction. It’s just like driving down a straight piece of road: 
there’s really only one way of doing it. 




print 
( "Howdy ! " ) 



print 
( "Come 
again ! " ) 



But programs need to be much smarter than that. 
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Codeville: Your program is like a network 
of roads 

Programs need to do different things under different circumstances. In 
the game, the code displays “You win!” if the user guesses the number 
correctly, and “You lose!” if not. This means that all programs, even really 
simple programs, typically have multiple paths through them. 




every program that are like 
road mtersedtions. 



rhe do^pu-teir tTUKS 

£o 7^ s i i 

ih e path" ,i hke 
through the eode. 



There are r»3hy roads (or 
paths) through the dode- 



A path refers to the set of instructions that the computer will actually 
follow (or execute). Your code is like a street network, with lots of sections 
of code connected together just like the streets in a city. When you drive 
through a city, you make decisions as to which streets you drive down by 
turning left or right at different intersections. It’s the same for a program. 
It also needs to make decisions from time to time as to which path to take, 
but for your code, it is not like driving along a road, it’s executing a particular 
path. 



Let's look in more detail at how a program decides 
which path to take. 
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fork in the road 



Branches are code intersections 



Driving down a street is easy. You need to make a decision only when 
you get to an intersection. It’s the same for your program. When a 
program has a list of commands, it can blindly execute them one after 
another. But sometimes, your program needs to make a decision. Does 
it run this piece of code or that piece of code? 




These decision points are called branches, and they are the road 
intersections in your code. 



Branches arc like road 
intersections. 



Your program makes a decision using a branch condition. A branch 
condition has the value true or false. If the branch condition is true, it 
runs the code on the true branch. And if the branch condition is false, it 
runs the code on the false branch. 




The V>rar£h 

tordvt'or- 



guess== 5 ? | 



The Computer will take this path the^ 
branch Condition is true— that »s, $uess 
is e<\ual to 5. 

The true path.. 

i 



Jbecmfuiar will like 
Condition is 
,s ' « somethin 



1 

The -false path. 
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if/el$e branches 

We’ve already seen a branch in the Python game program: 




if guess == 5: 

print ( "You win ! " ' 
else : 

print ( "You lose ! " ) 
print ( "Game over ! " ) 

Python, like many languages, has if /else branches. In our example, 
the branch condition is the if guess == 5ipiece of code. This is a 
test for equality and it will result in the value true or false. 

The code on the true path is indented, and given after the if line. The 
code on the false path is indented, and given after the else line: 



These c.<w«,ar>ds 
it -they ave cm the ?ath 
-the pv-o<yra»» takes. 



The -false path 






guess==5? ] 



print 

"Game over!") 



You need to amend the game program to give more informative messages 
to the user. 

But what will the paths in the program look like? 
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start your engines 





The made 

siami Ime is 
-fixed heme- 



Number entered 



Feedback message 



Too low 



You win! 



Too high 



Too high 



Race Thick ►»»»»»»»»»>3 

Construction Kit 



The countdown's started on the Codeville Grand Prix. The 
cars have arrived, they're warming their tires on the grid, 
and the race is about to start. Can you assemble the track 
so that it displays the right feedback message? Note that 
you might not need all the pieces of track. 
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finish line 



Race Track 
Construction Kit Solution 



The countdown's started on the Codeville Grand Prix. The 
cars have arrived, they're warming their tires on the grid, 
and the race is about to start. Were you able to assemble 
the track so that it displays the right feedback message? 




print 

( "You win ! " ) 



Number entered 


Feedback message 


3 


Too low 


5 


You win! 


7 


Too high 


8 


Too high 
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connect branches 



The Python code needs 
interconnecting paths 

The solution’s mapped out, and now we know that the program code will 
need to have paths that match this: 




But isn’t there a problem here? In the design there are many interconnecting 
paths, but so far, we have only written code that contains just one branch: 



if guess — 5: 

print ( "You win ! " ) 
else : 

print ("You lose!") 

In the new code, we will need to connect two branches together. We need the 
second branch to appear on the false path of the first. 




So how do you connect branches together in Python? 
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Python uses indents to connect paths 

The code inside the if and else statements is indented. This isn’t just 
to make the code pretty. In Python, indents matter. Let’s consider a 
different piece of example code: something that will decide if you can 
drive downtown. Python uses indents to connect a sequence of commands 
together to form paths. 



TWis is 
TRIAB path- 



This is •the 
FALSB path- 



INDENTs U Pytw> t 



4 

if fuel > 3: 



same path 



print ("It's OK") 

print ("You can drive downtown.") 
else;: 

print ("Sorry") 

rint("You don't have enough fuel") 
print ( "What ' s next?") 




This tommand is *i°t 0 » 
rALSt path because it is «ot 
indented- So it will always 



So how do you connect branches together? You simply indent the 
second branch in by one more level. 



The 



Jf ivst it Wa ' f ' tV ' 



This 



Xtond it bnaneh 
I s footed to the 

+'«t ,t branch. 



if fuel i> 3 : 

print ("It's OK") 

ipriht("You can drive downtown.") 
else: i 

J. if money > 10: 

!print("You should buy some gas.") 
jelse: 

|print("You better stay| at home.") 
print^f"What ' s next?") 



^tide the extra 
mdehtatioh. 




Watch it! 



Indents matter 
in Python. 

Be careful how 
you indent code in 
Python; if you don’t 
indent your code correctly, your 
code might do something wildly 
different from what you expect. 



You should now have enough information to go fix the code, but 
before we do that, let’s take a look at how IDLE helps you indent 
code. 
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idle time 






You’ll be using IDLE to enter all of the Python code in this book, so it’s 
worth taking a little time to familiarize yourself with a few of its features. 

Even though IDLE looks like a simple editor, it’s actually packed full 
of smarts that will make Python programming much easier and faster 
for you. It’s worth spending some time exploring IDLE’s menus and help 
system, but for now here’s a few handy hints to help you feel at home. 



vVhen you type a : and 

Wit enter, pyy 

y a nd Y 

indent th ene*tWt^Y ott - 



ID LB uses dolovs and 

hwkntinj by dlidking on 
Options menu (on the /V], 
' Called Preterendes). 



The Help menu ^ ^Y 

o,Wes you help about 
IDLfc, hut 't also lets you 

v-ead the W.lt-m Python 
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Paa] Puzz]e 

Your task is to take the Python code 
fragments from the pool and place 
them into the blank lines in the 
game. You may not use the same 
code fragment more than once, and 
you won't need to use all the code 
fragments. Your goal is to complete 
the guessing game program. 

Hint: Don't forget to indent. 



print ( "Welcome ! " ) 
g = input ("Guess the number: ") 
guess = int (g) 



Note: each code 




indent or else 




Pool Puzz]e §®]ufion 

Your task was to take the Python code 
fragments from the pool and place 
them into the blank lines in the 
game. You could not use the same 
code fragment more than once, 
and you didn't need to use all 
the code fragments. Your goal 
was to complete the guessing game 
program. 

Hint: Don't forget to indent. 



print ( "Welcome ! " ) 




This pi etc of Code 
-(Vonri -the -first version 
of -this program i s „ 0 
longer needed. 
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Tqst Drii/g 



So, what happens if you run the new version of the program? 

Let’s try a few tests. Remember, you will need to switch back to the 
program window for each run and choose Run module from the menu. 




The program works! But, are the users any happier? 
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another guess 




Why do I have to keep 
rerunning the program? 
You mean I only get one 
guess????? 



The users still don't like it. 



The program works, and now generates extra feedback, but 
there’s a problem. If the users want to have another guess, they 
have to run the program again. They really want the program 
to keep asking them for another guess until they finally get the 
correct answer. 

Gan you see what the problem is? 

How do we get the computer to do something repeatedly? Should 
we just make a copy of the code and paste it at the end of the file? 
That would make sure the user is asked twice. But what if they 
need to make 3 guesses? Or 4 guesses? Or 10,000 guesses? 
What about the case where the guess is correct? 

The guessing game program needs to be able to 
run some code repeatedly. 
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Wouldn't It be dreamy if 
there were a way to get a piece 
of code to run several times? 
But I guess it's just a fantasy... 



r ^ 
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loop around 



Loops let you run the same piece 
of code over and over again 

Programs often need to keep running the same piece of code 
many times. In addition to branches, programming languages also 
provide loops. 

Loops are a little like branches. Just like branches, loops have a 
condition (the loop condition) that is either true or false. Also, 
like the i f part of branches, if the loop condition is true, then 
a loop will run a given piece of code. For a branch, this code is 
called the body. For a loop, it’s called the loop body. 




,^7 ihe f°9^ tint reaches 
3 e '°°P' * ***** the value 
7 3 e loo P CoxdiW be-fore 
de£,dm 9 ^at ho do 



answer- no 



answer = 
input ( "Are 
we there?") 



FALSB 



print 

( "We' re 
there ! " ) 



the ^ loo?) the 

tilUo back fo the start ot -the loo? 

i I I _ « siiJ-w'm 



The big difference between a loop and a branch is how many 
times it runs the code associated with it. A branch will run its code 
only once. But a loop will run the loop body, then check the loop 
condition again and, if it’s still true, it will run the loop body again. 

And again. And again. In fact, it will keep running the loop body 
until the loop condition becomes false. 
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Python's while loop 



Programming languages have lots of different ways of creating loops, 
but one of the simplest ways in Python is to use a while loop. Here’s 
an example: 



y/e «awt 

s»vetV*W™" S 

the 

^answer 

while 



The 

r 



,00 P 




V* loo P tody is the 
,h ac*vtcd Code folUu • 
tte "while" t 9 



answer == "no" : 
answer = input ("Are we there? 
print ( "We f re there ! " ) 

This is what the loop looks like when you write it as a Python while loop. 
The code keeps asking the question “Are we there?” until the user types 
something other than no. This is what it looks like when it runs: 



"> ^ c 
The U? body is °» e lme f toAt 
• m this Wt ibe loo ? body ta* 

be n>a»y Ues ot tode- It *»•# eve* 
include Washes and 




Did you notice that you had to set the value of the answer variable to 
something sensible before you started the loop? This is important, because 
if the answer variable doesn’t already have the value no, the loop 
condition would have been false and the code in the loop body would 
never have run at all. 

Bear that in mind. It might be useful in this next exercise... 



Download at WoweBook.Com 



you are here ► 



29 




change the game 



Exercise 

m 



Now, it's time to apply your programming mojo. Be warned: this exercise is kind of tricky. 
You need to rewrite your game program so it keeps running until the user guesses the 
correct answer. You will need to use all of the things you’ve learned in this chapter. You will 
need to work out the conditions for each of the branches and loops that are required. 

Remember: the program needs to keep asking the user for an answer while the current 
guess is wrong. 



Hint: If you need to test that two things 



have different values, use the != operator. 




fcodeV** 
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tteapy Batce 

If you add these two lines of code to the top of your program: 

from random import randint 
secret = randint (1, 10) 

The secret variable will be set to a random number between 1 and 10. Modify your 
program from the facing page so that instead of the answer always being 5, it will 
instead use a random number from 1 to 10 as the answer. 



Vtfate *e*t ve«'o» ^ Yr- 
pvo<\van> wses the vaiwe 

Liable as -the ^veeta^ev. >... 
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new game 



£ki°N& ExcadSe 

JM^SoLutiOH 

You needed to rewrite your game program so it keeps running until the user guesses the 
correct answer. You needed to use all of the things you've learned in this chapter. You 
needed to work out the conditions for each of the branches and loops that are required. 

Hint: If you need to test that two things have different values, use the != operator. 




32 



Download at WoweBook.Com 



starting to code 




Reaps Bane 
0>pe 



If you add these two lines of code to the top of your program: 



from random import randint 



secret = randint (1 , 10) 

The secret variable will be set to a random number between 1 and 10. You were to 
modify your program from the facing page so that instead of the answer always being 
5, it will instead use a random number from 1 to 10 as the answer. 



Here a ve -the -fc»» tonn random impoy-i yand'mf 

** ‘tf ^ "■> 10) 

v-a^dow vwawDCV- 



^ucss ~ 0 




else; 

prirvtO'Too I ov/0 
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test drive 




Tost Drii/q 



So, what happens when you run the new version of your program? 





Your users love the program. 

And you created it all yourself By carefully analyzing the problem, 
deciding what the feedback needed to be, and working out the intricate 
looping and branching logic, you’ve created something that really rocks. 



Well done. You're on your way to becoming a real code 
jockey. 
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Your Programming Toolbox 

You've got Chapter 1 under your 
belt. Let's look back at what 
you've learned so far. 



i pvoy 3"' s dX 

traces AeC\Ae 
\oo?s «*eal tV "^ S ' 

jL 

4* sc*b a * awxC 3 Vd uC 
*/*■**"* 



pytu Tools 

* i-f/ else brashes 

* while |<>op s 

* ~ assignment operator 

* ~~ e< M'ty opera-tor 

* /= inequality operator 

* > Skater -than operator 

^ prihto displays a message Oh screen 
lh K° 9ets and returns user input 
W Converts characters to numbers 
^andintO produces a random number 
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Every strings 
# has its place 



Imagine trying to communicate without words. 

All programs process data, and one of the most important types of data is text. In this 
chapter, you’ll work through the basics of textual data. You’ll automatically search 
text and get back exactly what you’re looking for. Along the way, you’ll pick up key 
programming concepts such as methods and how you can use them to bend your data 
to your will. And finally, you’ll instantly power up your programs with the help of library 
code. 
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bean counter 



Your new gig at Starbuzz Coffee 

Starbuzz Coffee has made a name for itself as the fastest growing 
coffee shop around. If you’ve seen one on your local corner, look 
across the street; you’ll see another one. 

The Starbuzz CEO is always on the lookout for ways to boost profits, 
and he’s come up with a great idea. He wants a program that will 
show him the current price of coffee beans so that his buyers can 
make informed decisions about when to buy. 
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Here's the current Starbuzz code 

The previous programmer has already made a head start on 
the code, and we can use this as a basis. Here’s the existing 
Python code, but what does it do? 








Take a good look at the existing Starbuzz code. What do you think it 
actually does? 
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test drive 




Tost Drivq 



Type the code into IDLE, save the program, and run it. 



Here's f^ 3 " 
tode as entered 

i<vto |PL&- 



^7 



gate off seprlc-e . py - h ome-b ariy p/Hs a d Fir&iFr&g , c h a pte ri/cod a/g + 



File Frtit Format Run Options Windows 



: "• pc- : or L 1 ib . r c quc □ t 

page - tir L lib .request, url open < "http; //beans r uo. bis/ priced . html" } 

Lejc/L = p±'_|t: . Lfddij j .dt?L-udtf i| " jL CS" ) 



r 



j. :: L p_ efx L ) 



P 

I TV 



Python Shal* 



FjIp frltf r ihpJI ftehug nphans Windows 



When e*etu-ted, 
■the program 
yvodwtes this- 






license! tor more information. 
ERKTART 



J/ytbon J.0.1 (riUls&yiOb, l ! eb 15:13:3/) 

[ftrr 4.1.?]; cm 1 i nun? 

Type “copyright" r " credit s" 

JV,>,„Tfc 

<html><hcad>< t it lc>Hc lecw to the Econo 'R 1 Us Pricing Pagcc/titlO 
^-linK rel- "stylesheet" type-" text/ cs a" hrflr-"beansrua . esa " /--* 

< / head><body> 

<H2 XfelooM to the Beane 'R'Ua Pricing Paqet/M2> 

^pvCurrcnt price of coffee benns - <atrong>E5 .4&</otrong></p> 
cp^Price valid for 13 minmea from IS: 52 on Wednesday 27/03/2009 .t/p 
< /body >< /html> 



The code you’ve been left goes to the prices page on the 
Beans’R’Us website to get the current price of coffee 
beans. But instead of giving just the cost, it gives you all 
of the HTML text used to create the web page itself. 




I n: ’l4 C.nl 5 1 



This looks hke a £Lat 

HTML ^ ,s the 

used to tveale ?ay ' 






textual data 



The cost is embedded in the HTML 

Take a closer look at the results of the program. The current price 
of beans is right in the middle of the output: 



P 

nip rriit 



Python shall 



r .hf*JI n^hug Options Windows 




Pytbon J.0.1 (riuisfrl^fr, left 17 is : m : a-V) 

[GCC. 4. J EMI liana? 

Type ■ copy rig nt " „ "credits" or "Iiceneen" tor more information- 
»> p ns TART 



<htnil><hco.d><t it lc>Wc lector to the Bcana'R'Us Pricing Pnge</title> 
*M±nK rel- "atylesneet ' type- ”t emt / gbh “ br a r- n bean situs . css " /> 
</ttGad><fcody> 

> Welcome to the leans 'P. 'Us Pricinq Paqe^£'?TT>v. 

<p>Cu r ren t price of coffee beano - <atrongeS 5 * 49 \/otrong>Op> 
tp>Price valid for 13 mint res from 19:31 s day 27 / 03 /iO 09 L «/p> 

< /body >< /html> \ -Jou r»eed 



i his ,s d he ht ml tod C Tv " s ?ay ' 

^ -the pritt w e b P a 3e . *>«&**■* 



I n: 14 



The Starbuzz GEO would find it a lot easier if you could extract 
the price of beans and just display that, rather than have to look 
for it in the HTML. But how do you do that? 



A string is a series of characters 

The output of the Starbuzz program is an example of a string. 
In other words, it’s a series of characters like this: 




Somewhere within the string is the price of coffee beans. To 
retrieve just the price, all you need to do is go to the right bit 
of the string, retrieve the characters that give the price, and 
display just those characters. But how? 



You only need these -few ehav-attev-s. 

i 



< 



E [tj I rj [oj InJ y 
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Find characters inside the text 

The computer keeps track of individual characters by using two pieces 
of information: the start of the string and the offset of an individual 
character. The offset is how far the individual character is from the start of 
the string. 




start of the 
*”""9 f* 6 ’ * ** have „ ovec | 
places, the offset is O. 







The first character in a string has an offset of 0, because it is zero 
characters from the start. The second character has an offset of 1 , and 
so on: 



t o( Z 

Offset of I 



to* > 

, T, 





Otts'l 

values 



e 



lo ll 



li ii ft 



As we start Counting from 0, the 
offset valves are always one less 
than their actual position. 



The offset value is always 1 less than the position. Python lets you read a single 
character from a string by providing the offset value in square brackets 
after the variable name. Because the offset value is used to find a character, 
it is called the index of the character: 



W«,ber: -the first character 

has index O, so we are "off 

one when referring to an 
individual character. 
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textual data 



Put how do you get at more than 
one character? 

For Starbuzz, you don’t just need a single character. You need to extract 
the price from the string of HTML, and the price is made up of several 
characters. 



You need to extract a smaller substring from a bigger string. A substring 
is a sequence of characters contained within another string. Specifying 




here is waldo 




Imagine the variable s is set to the string below. Your job was to 
determine what each of the substrings provide. 





IxjyiJWSWlajlolUJ 



10 N 



12. , I? it IS I* \lj Jt 



V" 



\ 



s£/3:/0J 

though mde* I® 
is mCintioincd m ‘the 
substring sfeti-fitatoon, 
iVs no't in^lvded in ■the 
e*tvadted substring 



^*1 

Watch it! 



The second 
index value is 
after the last 
character in 
the substring 



This is even though the 
first index value is the start 
character of the substring. 
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r ^iharpen your pencil 

O tV'C V 



You need to update the program to extract the price starting at 
the 235th character of the string. The price is four characters long. 
Store the price substring in a variable called price. Write the 
new version of the program here: 




WrVte Q* ** 
tode Vvevr, 
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extract the price 




Solution 



You needed to update the program to extract the price starting at 
the 235th character of the string. The price is four characters long 
and stored in a variable called price. 



import urUibre^uest 

page =• uv-llibregues*tuv , lopeir>( u b't'tp : / / v/v/v/beaKS~v--us.biz/ pv-i£es.lvtml”) 

Vo* sW v* ****** m pvite - b*h:zi4r-im 

(V ,,W^ ..tMfnu). T. 

e*tvad*d swlostvm^). 





e^ivati and the twrvent 
pvide ot toffee- 



rD 

X 



r\a 

Uv 

■£> 
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lesr Drove 



Type the code into IDLE, save the program (choose a name for 
the program that is meaningful to you), and run it. 



9 etc off ee p ri ce! . p y ■ ,/home/barryp/H ee d f i rstP l og /cha p te r2yc odefget + - □ 



tile Lrfit Format Bun Options Windows 



JJelp 



urllib, request 



page 

test 



u r 1 lib, request . ur I open ( "http: / / www . beans- r - ua , bi z pr i cc s . html " \ 

page - reed ( ) . decode { "utf D \ 



pr ice - t ext [234:230!] 
print { price) 




That looks a lot cleaner. Now, instead of displaying the entire 
HTML text of the web page, you’ve cut it down to just the 
piece of the string (the substring) that you need. 







string theory 




The String 

This week’s interview: 

We ask the String what it’s like 
being the world’s most eligible 
datatype. 



Head First: String, it’s so good of you to find the 
time to speak to us. 

String: Please, the honor is mine. Sit. Sit. Make 
yourself at home. Did you eat yet? 

Head First: I’m fine, thank you. String, where 
should I begin? You are known the world over for 
your work. In your time you’ve carried the works of 
Shakespeare, Geothe... 

String: Dan Brown. 

Head First: ...all the great works of literature. And 
even mundane things like names and addresses. Tell 
me, how did you become so popular? 

String: It’s a question of character. Well, characters. 
See, before I existed, computer systems used to 
record text one character at a time. 

Head First: That must have been rather 
inconvenient. 

String: Inconvenient? It was a royal pain in the 
tuchis. 

Head First: Quite. 

String: Without me, handling text was like riding a 
pedal cycle without a saddle. 

Head First: In what way? 

String: It was possible to get somewhere, but the 
journey was kind of stressful. 

Head First: You simplify things. 

String: Certainly. I simplify. Instead of keeping 
track of a hundred, or a thousand, or a million 
letters, you just need keep an eye on one thing. Me! 



Head First: That’s a good point. 

String: I like to think of myself as a front. An agent, 
you might say, for all the characters I work with. 

Head First: People deal with you, so they don’t 
have to deal with individual characters in memory. 

String: Exactly. I’m an organizer. I keep an eye on 
the day to day business of the letters. If I need to be 
shorter or longer, I arrange for the characters to be 
made available. 

Head First: Tell me about your substrings. 

String: Ah, my substrings. Like chips off the old 
block. That a humble datatype should be so blessed! 

Head First: A tissue? 

String: Bless you. <blows nose>. Those boys are 
so close to me. Here’s a photo. Gan you see the 
resemblance? 

Head First: Why he looks just like... 

String: Ah, you guessed! Yes, my character 
sequence from 137 to 149. Exactly. Just like his old 
man. But shorter. Little more hair. 

Head First: Your substrings are strings as well. 

String: Certainly. Strings just like me. And they, I 
hope, should one day be able to produce their own 
substrings as well. 

Head First: Yet some people are confused by your 
indexing. 

String: What can I say? I started with nothing! 
Head First: String, thank you. 

String: A pleasure. Are you sure you ate? 
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So, I can put any web address into 
this code and grab the associated web 
page from the Internet? 



A: 



Yes, feel free to try it out for yourself. 



O: Don't I need a web browser to 
view web pages? 



Yes, to view a web page in all its 
formatted glory-with embedded pictures, 
music, videos and the like-a web browser 
is a must-have. However, if all you want to 
see is the "raw" HTML, a browser is overkill. 




What does the import line of code 



It gives the program the ability to talk 
to the Internet. The 

urllib . request code comes as 
standard with Python 3. 



therefore no 

Dumb Questions 



O: And I guess that call to urlopen() 
goes and gets the web page? 



That's right! The provided web 
address (or "URL" to use the proper web- 
speak) is fetched from the Internet and 
returned by the call to urlopen ( ) . 

In this code, the fetched web page is 
assigned to the page variable. 




And the urllib.request bit? 



That just tells the program to use the 
urlopen () function that comes as 
standard with Python 3's Internet page- 
reading technology. Well have more to say 
about urllib . request in a little bit. 
For now, just think how lucky we all are not 
to have to write code to fetch web pages 
from the Internet. 



I get that the call to read() actually 
reads the web page from the page 
variable, but what's thatdecode("utf8") 
thing? 

When the web page is fetched from 
the Internet, it is in a "raw" textual format. 
This format can be a little hard for humans 
to read. The call to decode ( ) converts 
the raw web page into something that looks 
a little easier on the eye. 

To see what we mean, try removing the 
call to decode ( ) from the program and 
running the code again. Looks a little weird, 
doesn't it? (Don't forget to put the call to 
decode ( ) back in before continuing.) 




BULLET POINTS 



■ You can download the HTML of a 
web page as a textual string. 

■ A string is a sequence of characters. 

■ You can access individual characters 
in a string using an offset. 

■ The offset is known as the index 
value of the character (or just index 
for short). 

■ Strings within strings are called 

substrings. 



Substrings are specified using 
two index values -for example: 

text [10:20], 

The first index value is the location of 
the first character of the substring. 

The second index value is the 
location after the last character of the 
substring (up to, but not including). 

Subtract the second index from 
the first to work out how long the 
substring should be. 
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change of address 



Peans'R'Us is rewarding loyal customers 

The GEO just got great news from the beans supplier. 



The supplier is so happy 
about all the business were giving 
them that they are going to make 
us members of their loyalty discount 
program. They say it should be a 
simple fix. Can you look into it? 



The supplier actually maintains two prices: one for regular customers 
and one for loyalty program customers. The different prices are published on 
different web pages: 

Regular dus-tomers jet 
their prides h err http 

: / /www . beans-r-us .biz/prices .html 



t siomcv-s http: / /www . beans-r-us .biz/prices-loyalty .html 

their prides here- 



That means you need to change the web page address in the code: 



import urllib . request 



page = urllib . request . urlopen ( "http : //www. beans-r-us .biz/prices-loyalty .html" ) 

text = page . read (). decode ( "utf 8 " ) 



price = text [234 : 238 ] 
print (price) 



rhis is the 
address. 



new 



Let's run it to make sure everything works OK. 
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Drwq 



This time when you run it, this happens... 




The program is no longer displaying a price. So what happened? 



The price moved 

The web page for loyalty customers is much more dynamic that the old 
web page. The page for regular customers always displays the price in a 
substring beginning at index 234. That’s not true for the loyalty program 
web page. The price on that page can be almost anywhere. All you know 
for sure is that the price follows the substring >$: 



m b* 




cron 



JUJLdbJUJ 



All yoM khow is that the pride 
Allows these two characters. 



You need to search for the price string. 
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searching for substrings 



Searching is complex 

You already know how to find a substring, so you could run through the 
entire web page and check each two characters to see if they match >$, 
like this: 



We tould seavdh through the 
whole tov ">/”» looking 

at 2- dhavatters at a twe- ^ 




< s 



cur 







<jii@[o] 



n 



[5j y [4j HJ [<j ^ 



31 : 




y < 




< ns t r o n 



EEUEEUI/J 



@ is e e 0 ® sys llJ UJ IS l»J 0 0 

We've touhd 




So these *e*t % 
dhavattevs be 
the y*-''de, vi^ht? 



You could do it this way... but should you? 



There’s a lot to worry about. Which two characters are you currently 
comparing? Where in the string are you right now? What if ">$" isn’t 
found? Searching for substrings in strings is a little more complex than it 
first appears... 



But if you don't want to write code to search the 
string, what else could you do? 
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Wouldn't it be dreamy if there were 
a simple way to search a string for a 
substring? But I suppose that's just a 
fantasy... 
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Python data is swart 

The more code you write, the more you will find that you need to do the 
same kind of things to the data in your variables all the time. To prevent 
you from having to create the same code over and over, programming 
languages provide built-in functionality to help you avoid writing 
unnecessary code. Python data is smart it can do things. 

Let’s look at an example. 

Imagine you have a piece of text in a variable that you want to display in 
uppercase (all CAPITAL letters): 



msg = "Monster truck rally. 4pm. Monday.” 



You could write code that read through each character in the string and 
printed out the matching uppercase letter. But if you’re programming in a 
language like Python, you can do this: 



T he 
"tail 
•the 



dot 

the method on 
syet'tied variable*. 




print (msg . upper ( ) ) 



IS a string method. 



MONSTER TRUCK RALLY. 4PM. MONDAY. 



Weve's what gets 
displayed, the value of 
the msg" variable in 

UPPERCASE. 



But what does msg . upper ( ) mean? 

Well, msg is the string containing our piece of text. The . upper ( ) that 
follows it is called a string method. A method is just an instruction for the 
string. When you call msg . upper ( ) , you are telling the string to give 
you an UPPERCASE version of its data. 

But is there a string method that can help you search 
for a substring within a string object? 
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These are some of the many built-in string methods that come with 
Python. Match each method to what it does. We’ve done one for you 
already. 



Mediod 



WWtlie m&thQcl does 



text.endswithC.jpg") 



Return a copy of the string with all occurrences of one 
substring replaced by another. 




Return a copy of the string converted to lowercase. 



Return the value True if the string has the given 
substring at the beginning. 



Return the value True if the string has the given 
substring at the end. 

Return the first index value when the given substring is 
found. 



Return a copy of the string with the leading and 
trailing whitespace removed. 



Return a copy of the string converted to uppercase. 




Which of the above methods do you need to use to locate the 
price substring within the Beans'R'Us web page? 
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find, the right method 






+ 






These are some of the many built-in string methods that come with 
Python. You were to match each method to what it does. 



Method 



Vfidt th& method does 




Return a copy of the string with all occurrences of one 
substring replaced by another. 



Return a copy of the string converted to lowercase. 



Return the value True if the string has the given 
substring at the beginning. 



Return the value True if the string has the given 
substring at the end. 



Return the first index value when the given substring is 
found. 



Return a copy of the string with the leading and 
trailing whitespace removed. 



Return a copy of the string converted to uppercase. 




Which of the above methods do you need to use to locate the 
price substring within the Beans'R'Us web page? 



The W ‘PmdO w method 
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E%enci$e 



You need to update your price-grabbing program so that it extracts the four-character substring 
that follows the occurence of the ">$" characters. Write the new version of your code in the 
space provided. 

Hints: Don't forget that the find() method finds the starting position of a substring. Once 
you've found use Python's addition operator to calculate where in the string you want to 
extract the substring. The addition operator is the "+" symbol. 



Seavth (or tW.s 2-tV.av-atlev- 



y° u * r ea lly 
looki »3 U. 



coffee beans = <strong>$5 . 4 9</ 
strong></p><p>Price valid for 
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Excise 

Sutton 



You needed to update your price-grabbing program so that it extracts the four-character 
substring that follows the occurence of the characters. 

Hints: Don't forget that the findo method finds the starting position of a substring. Once 
you've found use Python's addition operator to calculate where in the string you want to 
extract the substring. The addition operator is the "+" symbol. 



This dode 
hasn't . 
dh anged. \ 



import urllibre^uest 



page =• urllibre^uestuf lopenO'http : / / v/wwbeans--r--us.biz/ 
text — readO- 



L 



£ c a rf h f°vd he |o£ ^ io « 

e >/ fiombma-tion. '^'wbcvc — -tex-t-P'md('>?) 



This is -tbe addition opevaW- 



.TT. where + A ............ . 

The stair t o( the actual pride ~ — ~ ^ 7) 

is another Z i*dex positions end^ot^p^ide ==■ .^irt^c^^pride + T ^ 



along the string, while the end 
o\ the pride is another 



pride =• textCstart^o-P^pride : end^o-P^prideJ 



print^pride) 

\ 

Pid you remember to 

print out the pride 
onde you'd -Pound it? 




1/Vith the start and end index 
lodations known, it's easy to 
spedi-Py the substring required- 
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Tost DriVq 



OK, so your program should now be able to find the price, no matter 
where it appears in the page. 




It works! By adding very little extra code, you have made the program 
much smarter and more useful. 




! 





frugality feature 




The new version of the program works, but 
now there's a design issue. 

The Starbuzz GEO wants to know when the price of 
the beans falls below $4.74. The program needs to keep 
checking the Beans’R’Us website until that happens. It’s 
time to restructure the program to add in this new feature. 

Let's add a loop to the program that stops 
when the price of coffee is right. 
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Code Magnets 

The program code to add the feature is sitting on the fridge door. 
Your job is to arrange the magnets so that the program loops until 
the price falls to $4.74 or lower. 




page = urllib . request .urlopen ("http: //www.beans-r-us .biz/prices .html") 
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Code Magnets Solution 

The program code to add the feature was sitting on the fridge door. 
You were asked to arrange the magnets so that the program loops 
until the price falls to $4.74 or lower. 



import urllib . request 
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Tost Drivs 



Enter the new version of the program code into an IDLE edit window and 
run it. 



gctcetfeeprke4.py - ihomtjba rry p i'Nc adF irst P rsg .ch ap t« igfiteoff eepri ce4. p y + - J * 



Lite |dil Format linn uptions w&ndtsws 



Help 



u 1 1 lib j l. ec^ue s L 

price 55.95 

price > 4.?4: 

paqe ■ unlit- request „ urlopenf " http: / /ww. beans -r- us . bir /price s- loyalty .Jitnl" J 
Lt?xt ■ paLje - r end £ J . d.ri.-Lwie' \ " j L I B “ J 

wVi^rf! - taxt. ,_f lnd ( r >5 " ]f 



start_K>t_pnee - %’h ■:■ i _>- + 
end_oE^prica - start M 1 



I 



Weire's youv 
program Code 
typed iht> 

ID LB. 



Pythen Shell 



’j ■ —fjij = Lrxt | 9 L-bx r_ ij, 

print ("Duy!"} 



flip £riit SheJI JVbiLgi ^ptunns Windows 



^at’s tW»s? ■ 



Python 2-0-1 *rJ£l :S933&, Fe& 17 2D09| 13:13:37) 

[GCC 4.1.21 on Linux 3 

Type "copyright", "credits" or 'license()“ for more Ini Dnnation. 
>» ■— ■— —————*— ■ i i HESTAHT 

»■> 

Ti aL‘ffbai_’J. j mua L rec:Bnt lb II las.. ) : 

File "/DoL-emeisLa^qi? tL-uf TcepE ice4 .py “ r line 3, in ^inotlLLlr> 
while priLte > 4.74i 

Typc-RTrof i unnrrir rnlh l ^ ■fyp^fi: aPr[ ) > flontlj) 

»> 1 



fcfPlp 



Ln: 10 col: 4 1 



It looks like something’s gone wrong with the program. What does 
TypeError mean? What’s happened? 







Look at the error message in detail. Try to identify which line in the code 
caused the crash and guess what a TypeError might be. Why do you 
think the code crashed? 
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Strings and numbers are different 



The program crashed because it tried to compare a string with 
a number, which is something that doesn’t make a lot of sense 
to a computer program. When a piece of data is classified as a 
string or a number, this refers to more than just the contents of the 
variable. We are also referring to its datatype. If two pieces of 
data are different types , we can’t compare them to each other. 



Think back to the previous chapter. You’ve seen this problem before, 
back when you were working on the guessing game program: 



In the guessing-game program, you needed to convert the user’s guess 
into an integer (a whole number) by using the int ( ) function. 

But coffee bean prices aren't whole numbers, because they contain 
numbers after a decimal point. They are floating point numbers 
or floats, and to convert a string to a float, you need to use a 
function other than int ( ) . You need to use float ( ) : 




TWis vav'iaWe 
se-t -to a 




float ( " 
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Tost Drove 



This should be a pretty quick fix. If you use the float ( ) function to 
convert the price substring, you should then be able to compare the 
price to 4.74: 



gcte*fTecprkc4.py -/homc/barry|^hlcadFlmPrag/chapter2yc«]c/gctcafFceprlcc4.pv + - n 



FHtt Edit. Fyrnidt Run OpLiunii Wiiiduwi. 



Help 



if lk. : ' ui 1 lib . i tf yue h *. 
price - 99.99 
v:\ilc price > 4.74: 

paqe - ur I 1 id . request . urlopon | " nt t p : / / ww . da ana -r-c a . d i z / price a -loyal ty . honl n | 
t.r-.-xb. — . rrnrl ( J . H nt f ! " ) 

wlicit = Lt: j. 1_ . iijiii ( ' '-■$ ' J 

start_ot_price - where + 2 

traid ui priirtr = aLarL ui piiutr + it 

price - r loat \ te Kt [ starr_o r_pr ice : end_c f _pr lc e | ) 



Python Shell 




He Ldit Shell Debug Dpt ions Wtndows 



Python 1.0.1 <rJ01;G955G, Tcb 17 2009, 15;I5:57} 

[GCC 4.3.2] or. Iinux2 

Type H copyright* , “credits" or " license () 11 for more information. 
>» ============= ============= ====== RESTART ================== 



The program runs 
with ko problems 
this time. 



J 



Help 



The undated tode- 



Huy ! 



Lrt: 7 CoS^ 4 1 



That’s much better. Your program now waits patiently until the 
price falls to the right level and only then does it tell the GEO that 
the time is right to buy a fresh batch of coffee beans. 
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the department of WEBLAND security 

fe (WT WE KNOW 

■ WHERE YOU LlVU 



WHERE YOU Livt, 

WASHINGTON , D.G. 

From: The De ^ r ^orporatf Enforcement Unit 

Secret Service 



To Whom It May Con Distributed Denral 

. . nn i n to an apparent domain 

A recent tte -.chine. 

° £ Se rSt' 1* ° £ “ e tEaf£1C tl et l » ,l tro» around the »«“' 

rdfetn 

. h t p e powers rnves e alerting the 

in accordance with y General, « klnd „f 

bJ ce United States ^ ^ „ tate ct 
developer of the 

thing- In short- niirself on notice. 

o u d consider yonrseir 

We , re watching Y ou ' 



Yours 



faithfully f 



Head ot internet 



Affairs 



textual data 



The program has overloaded 
the Peaws'R'Us Server 



It looks like there’s a problem with the program. It’s sending so many 
requests that it overwhelmed the Beans’R’Us website. So why did that 

happen? Let’s look at the code and see: , 

fWs the code 

import urllib . request 
price = 99.99 
while price > 4.74: 

page = urllib . request . urlopen ( "http : / / www . beans-r-us . biz /prices . html " ) 
text = page . read (). decode ( "utf 8 " ) 
where = text . find ('>$' ) 
start_of_price = where + 2 
end_of__price = start_of_price + 4 
price = float (text [ start_of_price : end_of_price ] ) 
print ("Buy!") 




If the value of price isn’t low enough (if 
it’s more than 4.74), the program goes back 
to the top of the loop immediately and sends 
another request. 

With the code written this way, the program 
will generate thousands of requests per 
hour. Multiply that by all the Starbuzz 
outlets around the world, and you can start 
to see the scale of the problem: 



You need to delay the pricing 
requests. But how? 
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Time... if only you had more of it 

Just when you’re feeling completely lost, you get a phone call 
from the Starbuzz coder who wrote the original version of 
the program: 




It seems that she can’t get back because of a storm in the 
mountains. But she does make a suggestion. You need to regulate 
how often you make a request of the Beans’R’Us web server. One 
way to do this is to use the time library. This will apparently 
make it possible to send requests every 15 minutes or so, which 
should help to lighten the load. 

There’s just one thing: what’s a library? 
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You're already using library code 

Look at the first line of the original code: 




sa y s we are 

| the urllib.re^uest" librar ■ 1 



The import line tells Python that you intend to use some library code 
called urllib. request. A library is a bunch of prewritten code that 
you can use in your own programs. In this case, the urllib. request 
code accesses data on the Web. This is a library that comes as standard with 
Python. 

To see how the code is used, look at this line: 




Libv-av-y 



£vev-v V«Wary ton-ka^s 
WW* khak. yo* ta» 

wse m own yv-oOyraw 



The code that follows the = sign is calling a function in urllib . 
request called urlopen ( ) . Notice how we say we want the code: 
urllib . request, followed by a then the name of the function. 





But how will the time library help us? Let's see... 
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find the time 



m 



£oh£ ExeRciSe 



These are some of the functions provided by Python’s built-in time library: 



Python library Documentation: time 



current time in seconds, given as a floating 
point number. 

tl ”' d *?h“ 9b returns 0 if yon are not currently in 
Daylight Savings Time. 

time . gmtime () time (not affected 

Tells you current UTC date anu 

by the timezone) . 

time . localtime () {is affected by 

Tells you the current local time t 

your timezone) . 

ti ~' Sl DoT-t““'a„ytning for the specified number of 
seconds . 

““•“'is you the number of seconds since January 1st, 
1970. 

tl ”' ti ?nTyou the number of hours difference bet.een 
your timezone and the UTC timezone (London) . 



You need to use one of these functions to help you fix your code. 

But which one? Draw a circle around the function you think you might need. 
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With the appropriate function identified, amend the code to control how often the request for 
the web page is sent to the server. The Beans'R'Us webmaster has been in touch to say that 
their web-based pricing information is updated every 15 minutes. Fill in the blanks in the code 
as indicated by the dashed lines. 

Hints: 15 minutes equates to 15 multiplied by 60 seconds, which is 900 seconds. Also: to use 
the functionality provided by a library, remember to import it first. 



import urllib . request 



price = 99.99 
while price > 4.74: 



page = urllib . request . urlopen ( "http : / / www . beans-r-us .biz/prices. html " ) 
text = page . read (). decode ( "utf 8 " ) 
where = text . find ( ! >$ 1 ) 
start_of_price = where + 2 
end_of_price = start_of_price + 4 
price = float (text [ start_of_price : end_of_price] ) 
print ("Buy!") 
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time is on our side 



M 



£ong ExeftciSe 

§OLutlOrt 



These are some of the functions provided by Python's built-in time library: 



Python Library Documentation: time 



S 

TW.s looks 

like Lke best 

•fwt-t'on to «*se 



tl ”' Cl Ito current ti„. in seconds, given .s a floating 
point number. 

returns 0 if you »« not onrrently in 
Daylight Savings Time. 

time . gmtime ( ) time (not affected 

Tells you current UTC date anu 

by the time zone). 

time. localtime () . time (is affected by 

Tells you the current local time v 

’ - your*^itsJ2iezone) . 

'‘‘“'‘’Sf’tT WSNng for the specified n»ber of 

conds since January 1st, 



time .time () 



Tells you the number of sec 
1970 . 

time . timezone () h difference between 

Tells you the number of hours airie /T _^^ 



your timezone 



and the UTC timezone (London) . 



You need to use one of these functions to help you fix your code. 

But which one? You were to draw a circle around the function you thought you 
might need. 
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With the appropriate function identified, you were to amend the code to control how often the 
request for the web page is sent to the server. The Beans'R'Us webmaster has been in touch 
to say that their web-based pricing information is updated every 15 minutes. You were to fill in 
the blanks in the code as indicated by the dashed lines. 

Hints: 15 minutes equates to 15 multiplied by 60 seconds, which is 900 seconds. Also: to use 
the functionality provided by a library, remember to import it first. 



page = urllib . request . urlopen ( "http : // www . beans-r-us . biz /prices . html " ) 
text = page . read (). decode ( "utf 8 " ) 
where = text . find ( f >$ ! ) 
start_of_price = where + 2 
end_of_price = start_of_price + 4 
price = float (text [ start_of_price : end_of_price ] ) 
print ("Buy!") 




c 



pvovides- 

import urllib . request 

imp t time 
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Order is restored 

Starbuzz Coffee is off the blacklist, because their price-checking 
programs no longer kill the Beans’R’Us web server. The nice 
people at Webland Security have, rather quietly, gone away. 

Coffee beans get ordered when the price is right! 
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Your Programming Toolbox 

You've got Chapter 2 under your 
belt. Let's look back at what you've 
learned in this chapter: 



... o r individual tbavattevs- 
* prowamwm^ libravie ? 

~JWIt «4e «> | . toea 

* As «» as ka** a -aW«. *>» p j 

"data type " 

* Number ts a data type- 

* String ,s 3 ^ C ' 



Py^Hoh Tools 



string V Tup 



*w"u J ^ 5tK of variabl, V, 

^ _ a ,,,„ . , . 

bu 't iwt including) 3 th 

“PPERCAS E tth ° d f " s^iajs fa 

^ floa-tO CoY\\/eY'4-c c-Au.* / 
known as ''-floats" de£,fn ^ point numbers 

I 

addition operator 
* =• voter tka„ Oferau 
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# Let's get organized 




As programs grow, the code often becomes more complex. 

And complex code can be hard to read, and even harder to maintain. One way of 
managing this complexity is to create functions. Functions are snippets of code that 
you use as needed from within your program. They allow you to separate out common 
actions, and this means that they make your code easier to read and easier to maintain. 
In this chapter, you’ll discover how a little function knowledge can make your coding life 
a whole lot easier. 
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Starbuzz is out of beans! 

The Starbuzz buyers love the program you created in the 
last chapter. Thanks to your efforts, the Starbuzz GEO 
is only buying coffee beans when the price drops below 
$4.74, and his organization is saving money as a result. 

But, now there’s a problem: some Starbuzz outlets have 
run out of beans. 



We have a worldwide crisis! We've 
run out of coffee beans in some of our 
stores, and we've lost some customers, too. 
My buyers are only buying coffee when 
the cost is low, but if we run short on 
coffee supplies, I'll pay any price. 



When the coffee beans start to run low in an outlet, 
the Starbuzz baristas need to be able to send an 
emergency order to the GEO. The outlets need 
some way of immediately requesting the purchase of 
coffee beans at the current price, regardless of what 
that price is. They also need the option of waiting for 
the best price, too, just like in the current program. 



The program needs an extra option. 
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What docs the new program need to do? 

The new program for Starbuzz needs to give the user two options. 

The first option is to watch and wait for the price of coffee beans to drop. 
If the user chooses this option, the program should run exactly as it did 
before. 

The second option is for the user to place an emergency order. If the user 
chooses this option, the program should immediately display the current 
price from the supplier’s website. 



Here's the existing code for Starbuzz. You need to modify the program 
to add an emergency report feature that will immediately report the 
current price. Which parts of the code can you reuse to generate the 
emergency report? Grab your pencil and circle the part of the code you 
think you might reuse. Why do you think you'll need to resuse this code? 




import urllib . request 
import time 

price = 99.99 
while price > 4.74: 

time . sleep ( 900 ) 

page = urllib . request . urlopen ( "http : / / www . beans-r-us . biz /prices . html " ) 

text = page . read (). decode ( "utf 8 " ) 

where = text . find (’>$' ) 

start_of_price = where + 2 

end_of_price = start_of_price + 4 

price = float (text [ start_of_price : end_of_price ] ) 

print ("Buy!") 
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reuse code 



Solution 



Here's the existing code for Starbuzz. You needed to modify the program 
to add an emergency report feature which will immediately report the 
current price. Which parts of the code can you reuse to generate the 
emergency report? You were to circle the part of the code you think you 
might reuse as well as state why you might need to reuse it: 



import urllib . request 
import time 



H ccts *bhe &odc you 
ta* reuse. 



price = 99.99 
while price > 4.74: 

time . sleep ( 900 ) 

^ page - urllib . request . urlopen ( "http : / /www . beans-r-us .biz /prices . html " ) 
text = page . read (). decode ( "utf 8" ) 
where = text . find (’>$' ) 



start_of_price = where + 2 

end_of_price = start_of_price + 4 

price = float (text [start_of_price : end_of_price] ) 






print ("Buy!") 



Wether you wait &r the 
T'9ht pride or revest a* 

°^er, you'll *eed 
this code m each case. 




If you just copy and paste the same code, 
it could make your program very long. And 
hard to maintain. That's why you don't want 
to duplicate the code. 



Imagine »*f y ou 
had bo maintain a 
program “this length- 



80 



Download at WoweBook.Com 




functions 



Pon't duplicate your code... 



When you need to add a new feature to a program that’s similar to some 
other code in the program, you might be tempted to just copy and paste 
the code. 

In practice, that’s actually a pretty bad idea, because it can lead to code 
bloat. Code bloat means that you have more code in your program than 
you actually need. Your programs will get longer, and they’ll get a lot 
harder to maintain. 



You’ll W^attodcWoaV.* 
■ — Y lots ot yvoyams, 

c-orrvrrvorv W ! 



Here's the printout of the tic-tac-toe 
game. If you really want me to change the 
colors of the crosses, I'll just need to replace 
the code that displays each of the 9 squares. That's 
the same code in 9 different places. Oh, and if you 
want me to change the Os... 



... Reuse your code instead 

Programming languages all come with features that allow you to reuse 
code. So what’s the difference between copying and reusing code? 




If you copy code, you simply duplicate it. But when you reuse code, you 
have a single copy of the code that you can call in all the places that 
you need it. Not only will your programs be shorter, but it also means that 
when you amend code, you will need to change it only once and in one 

place only. 
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define your function 



fyvt the -Puhdtioh a hdr»e. 



The tode 
Njou shave «S 

'mderAe^ 



Reuse code with functions 

Most programming languages let you create reusable, shareable code with 
functions. A function is a chunk of code that you separate out from the 
rest of your program, give a name, and then call from your code. 

Different languages have different ways of creating functions. In Python, 
use the def keyword to define a new function. Here’s some Python code 
that defines a make_smoothie ( ) function: 

The ja»«ti»eses ave hwfortawl. 

^ so \)t suve “they*. 

def make_smoothie ( ) : ~ ~ 

juice = input ("What juice would you like? ") 
fruit = input ("OK - and how about the fruit? ") 
print ( "Thanks . Let's go!") 

\ print ( "Crushing the ice...") 
print ( "Blending the " + fruit) 

print ("Now adding in the " + juice + " juice") 
print ( "Finished ! There's your " + fruit + " and 



A WW ,s a c 
Wed"»Y ?' ete 
v-eusaWe t ode- 

id 





+ juice + " smoothie!").. 



In Python, it’s important that you define the function before you use it, so 
make sure the code that calls (or uses) the function comes after the definition 
of the function: 



Call the 
-PuK^tioK. 
Note -the" 
use of 
pavehS. 



print ( "Welcome to smoothie-matic 2.0") 
another = "Y" 
while another — "Y" : 
make_smoothie ( ) 

another = input ("How about another (Y/N) ? ") 




• L v.imiVS tP ^ \t 



Every time that Python sees make_s moot hie ( ) in the code, it jumps 
to the code in the make_smoothie ( ) function. It runs the code in the 
function until it gets to the end, and then returns to the next line in the 
code that called it. 



Let's use functions to share code within your program. 
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Cocte Magnets 

Before you amend the existing coffee bean program code, let's 
see if you can create a function to display the current bean price. 
Rearrange the magnets in the correct order to create the function: 






— 

page = urllib . request . urlopen ("http: //www.beans-r-us .biz /prices . html") 

text = page. read() .decode ("utf 8") 

where = text . find (’>$') 

start_of_price = where + 2 

end_of_price = start_of_price + 4 
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order matters 




Code Magnets Solution 

Before you amend the existing coffee bean program code, let's see 
if you can create a function to display the current bean price. You 
were to rearrange the magnets in the correct order to create the 
function: 



You still »eed to i»?«rt libraries 
betove usin$ them •*» 3 +undtion- 






import urllib . request 



The ‘function 
de-C'mi'bo* 
stav-'b here- 



You need a dolon after 
the function na*»e- 



R 7 ! 



get_price () 




The body of the £»ndtion 
needs to be indented- 



The -fundtion needs 
to be dedlaved 
beW it's tailed- 



page = urllib . request .urlopen ("http: //www.beans-r-us .biz/prices .html") 

text = page . read () . decode ("utf8") 

where = text . find (’>$') 

start_of_price = where + 2 

end_of_j?rice = start_of_price + 4 



print ( text [start_of_price : end_of_j?rice] 



Q 



get_price ( ) 



The 

dc-(’ur\*‘tiovi ends here- 



.. .. / 

This Ime ish t indented, 

because it is part o-f 
the main program. 



Always get things in the right order 

When it comes to functions, the order in which you do things 
really matters. The get_price ( ) function needs to be 
defined before you call it. And because the function relies upon 
some code in the urllib. request library, you need to make 
sure that the import line appears before the function, too. 

Let's see if your new code works. 
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Tost Drivq 



Type the code on the opposite page into IDLE, and run it to see what 
happens: 



■ gvtprice.py ■ /hom eyba rry p/H t<d d Pir P rog /ch a p t«r 3 /cDde^e t p r ke. p y + ■ C X 



Filtd EJjL Fuimdl Run Opjtiu(i!> Windows Hylp 

imp url lib. request 

! i- T lji-t I , j:r a 4 ( J : 

page = ur 1 1 lb . r eque at.ur lopen ( "Http: / /ww . beans -r-us . bi i ^prices . html " J 
text - page . read [ ] .dec ode < " '-it t t ] 
where — text . £ind( " >S " ) 

Ml .-l p I ciT jir Itzf. = ^it-rr 1 + I? 

end el price => start or price + 4 
prints text | star t_oi_pr ices end_oi_pr ice | ) 



get_p-rice( ) 



l^hch “this Code iruhs, 

ihe price is displayed 
''■ijht away. (Ho{.e- you 
**ay see a d\((crcnl 




price when you run your 
Code.) 7 



Python ShelJ 



File rrlrt r.hejl ftehug Hptinn^ WinrlnwR 



i'ytbon i.l trdls^dh^, Jul B iiUUli* UbsUBsUBJ 

[OCF on liriLiA? 

Type ■ copyright " r "credits" or "Iiecnsc()“ lor more information. 
»> ========================= H EKThRlT ==== = ======= = ====== 

>» 

J 5 _ Th 1 

»> I 



jjplp 



L n 7 Oil: d 



The price appears immediately. You now have a function that reads the 
contents of the page from the supplier’s website and prints out the price 
information. 

You can reuse the function in lots of places in your program simply by 
calling the get_price ( ) function. Now all you have to do is modify 
your existing program to use the new function. 










Look back at the original program at the start of the chapter. You know that you 
can use this function to produce emergency reports. But it will also need to 
replace the existing price-watch code. Is there a problem? Why? Why not? 
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limits of print 




Functions are great for reusing code, but they 
really come into their own when they perform 
an action for you, then give you back some 
data to use in whichever way you want. 



The current version of the get_price ( ) function prints out 
the price of coffee beans every time it is used, or called. This 
is OK if that’s what you really want it to do. The trouble is, you 
need the function to give you the price so that you can then 
decide what you want to do with it. 




discount = 0.9 

print ("The discounted price is: ") 
price = get_price() 
actual_price = price * discount 
print (str (actual_price) ) 




The "pei_f>\ri teO" 
function. Ever, the 
»ar»e tells you a little 
about what it does. 
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Return data with the return command 

If you use the return ( ) command within a function, you can send a 
data value back to the calling code. 



import urllib . request 



def get_price(): 



urllib . request .urlopen ( "http : //www.beans-r-us .biz/prices .html" ) 
page . read () .decode ("utf 8") _ ■. ._»» i 

= text. find (•>$') Remove tile u\\ to 



page = 
text = 
where 

start_of_price = where + 2 
end_of_price = start_of_price + 4 

return (text [start_of_price : end_of_price] ) 



>ao"-- 



- 3hd replace it with a 
^ 'VetuvnO" instead. 




£t v - ph “ 0 ' 
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don't repeat yourself 



there .are no 

Dumb Questions 



Q: The return!) command is just like print(), except nothing 
appears on screen, right? 



O: What happens if the function omits the return!) 
command? Does each function have to have one? 



Well... sort of. The print ( ) command is designed 
to display (or output) a message, typically on screen. The 
return ( ) command is designed to allow you to arrange for a 
function you write to provide a value to your program. Recall the 
use of randint ( ) in Chapter 1: a random number between 
two values was returned to your code. So, obviously, when 
providing your code with a random number, the randint ( ) 
function uses return ( ) and not print ( ) . In fact, if 
randint ( ) used print ( ) instead of return ( ) , it 
would be pretty useless as a reusable function. 



% So, it's a case of return!) letting a function give you 
something back? 



Yes, that's it, exactly. 



v; I'm not sure I'm convinced about using functions. Isn't 
using copy'n'paste quick and easy? 

No, using copy'n'paste is quick and dirty, with the emphasis 
on the “dirty." When you need to repeatedly use some code, it's 
always better to create a function to contain and name that code. 
You then call (or invoke) the function as needed. If you later decide 
to change how the repeated code works, it's a no-brainer to change 
the code in the function once. If, instead, you “quickly" performed 
copy'n'paste five times, that's five changes you now have to make, 
and the chance of you missing one change or making a mistake are 
actually pretty high. So, don't copy'n'paste! 



% So, using a function lets you share the repeated code in 
a controlled way? 



Yes, it does. There's also a guiding principle among 
prgrammers known as DRY: Don't Repeat Yourself. Using functions 
lets you keep your code DRY. 



No, the use of return ( ) is not required. In fact, the 
current version of your get_price () function doesn't use 
return ( ) at all. But, your function feels like it gives you 
something because it prints the current price on screen. When the 
return ( ) command is omitted, a function returns a special no 
value. In Python, this value is called None. 




So, just to be clear, using return!) is optional? 



Yes, it is. 




Does return!) always come at the end of the function? 



Usually, but this is not a requirement, either. The 
return ( ) can appear anywhere within a function and, when it 
is executed, control returns to the calling code from that point in the 
function. It is perfectly reasonable, for instance, to have multiple 
uses of return ( ) within a function, perhaps embedded 
with if statements which then provide a way to control which 
return () is invoked when. 



Q.: 

caller? 



Can return!) send more than one result back to the 



Yes, it can. return ( ) can provide a list of results to the 
calling code. But, let's not get ahead of ourselves, because lists are 
not covered until the next chapter. And there's a little bit more to 
learn about using return ( ) first, so let's read on and get back 
to work. 



88 Chapter 3 



Download at WoweBook.Com 



functions 




Using the new get_price ( ) function, write a new version of the 
price-checking program that does this: 

1 . Ask the user to indicate if the price is required immediately (Y/N). 

2. If the user chooses "Y" for "yes," find the current price and display it 
on the screen. 

3. Otherwise, check the price every 1 5 minutes until it falls below 
$4.74, then (and only then), display the price on screen. 
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buy it now 




Using the new get_price ( ) function, you were asked to write a 
new version of the price-checking program that does this: 

1 . Ask the user to indicate if the price is required immediately (Y/N). 



Youv tod t r*ay look a 
di-f-ferewt 4Vo» this, but thats 
0$(. f\i lo «5 as it does the same 
th'm^ youVe dom^ £ me - 



2. If the user chooses "Y" for "yes" find the current price and display it 
on the screen. 

3. Otherwise, check the price every 1 5 minutes until it falls below 
$4.74, then (and only then), display the price on screen. 



import urHibre^ues-t 



import “time 



def 

page =■ uv-llib.v-cc l ucst.uv-lop^( w bttp:/ / y/y/y/bcar\s-\r-us.bi2/p\ridcs.lvti^r0 
ie*t =■ p 

where =■ 'te*t'P‘md( 1 >?0 



star-t^o-f^pv-idc — where + Z 
erd^ofjpride — siav-*t^o^*^p\ridc + 

. return 'float(*te%*tCs*tar*t r pride : e*d o-f prideJ) 

Ypy *ttd to ask "the user { n 

•*P the pride is required ride__*ow — mput( w Do you want to see the pride kow w ) 

immedia-tely. A 

i-f pride^now 'V* : 

|jp use looses T. display 

■the value -that the getjpviteO ^ 

•fundtiox yves you- 

P'rife-llll 



(1 while pride > 

1+ the usev decides to wait tov- 

the price to drop, get the pride time sleep^OO) 

“ ih 9 the 9 et_priceO Wtio«,_^T' "" 

theh use the give* value -to ^ pride - get^pndeCv/ 

tty tt ~ w > III 



90 



Download at WoweBook.Com 



functions 




Tqst Drivs 



See what happens when you run the new program. Make the required 
changes in IDLE and take your new program for a spin: 





Design principle: reuse code with functions. 



you are here ► 
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* 






going mobile 





The CEO wants the price sent to his 
cell phone. 

Rather than have the emergency report displayed 
on a PC, the Starbuzz GEO would prefer to get 
something more immediate while he’s on the 
road. He needs messages to be sent directly to his 
Twitter account. 







Sending a message to a Twitter account feels like a tall order. 
Where do you think you’d start looking for helpful suggestions and, 
quite possibly, a solution to this new problem? 
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Use the Eem; Luke 



It’s pretty complicated to write a program that sends messages to a service 
like Twitter. Fortunately, other people have already tackled problems like this 
and posted their code on the Web. Here’s a Python function (found on the 
Web) that is very similar to what you need: 



This is -the te^-t ot the 
message that f be s «"t- 



def send_to_twitter ( ) : Yx Put Vour 

put V°uV iNUltw / 

msq = "I am a message that will be sent to Twitter" ' 'W'vter 

usev*amc V>cvc - password 

password_manager = urllib . request . HTTPPasswordMgr ( ) V 

\ f neve. 

password_manager . add_password ( "Twitter API", J. J, 

"http : / / twitter . com/ statuses" , "...") 

http_handler = urllib . request . HTTPBasicAuthHandler (password_manager ) 
page_opener = urllib . request . build_opener (http_handler) 
urllib . request . install_opener (page_opener ) 
params = urllib . parse . urlencode ( {'status': msg} ) 

resp = urllib . request . urlopen ( "http : //twitter . com/statuses/update . j son" , params) 
resp . read ( ) 



This code looks complex but, for now, all you need to know is that it sends 
a message to the Twitter service. An advantage of using functions (which is 
illustrated here) is that they allow you to understand a program at a high level 
without having to initially understand all the details. This is known as working 
at a higher level of abstraction. 







This code looks like it could be useful. But is 
there a problem? 

Why can’t you just replace the print ( ) 
calls in our existing program with calls to this 
function? 



t 

r 



T 

Da fl its! 



To use the code you will first need 
to sign up for a free Twitter account. 
To register, go to: 

https : / / twitter . com/ signup 
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the message stays the same 



The function always sends the 
same message 



Remade -the 
tails to 
Vm-tO" 




The Starbuzi 
CEO's homepage 
on Twi-fc-fcer. 



Mo matter whith oyW'«s theses ty the user, -the 
«s° d to UW)" UW sends ^e «« Wet to 



"sendjoj 

Twitter- 
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def send_to_twitter_price_low ( ) : 

# original code here . . . 

# . . .but change message to 

# buy at low price. 



def send_to_twitter_emergency ( ) : 

# original code here. . . 

# ... but change message to 

# place an emergency order. 



f 







Something doesn’t feel quite right about this solution. 

Can you see the problem that this creates? Can you 
think of a solution that fixes the problem? 



Lines -that start With * are Uvm 
as tommenb in Python- Co»>">ents 
are fcode annotations ywt there y a 
todcv and ave wcan-t “to be v-ead y 
other fcoders workii* With the tode- 
python ignores all domments, betawse 
they aren't e*edutable tode- 
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set parameters 



Use parameters to avoid duplicating 
functions 

Just like it’s a bad idea to use copy’n’paste for repeated usages of code, it’s 
also a bad idea to create multiple copies of a function with only minor 
differences between them. Look again at the proposed send_to_ 
twitter_price_low ( ) and send_to_twitter_emergency ( ) 
functions on the previous page; the only difference between them is the 
message they send. 

A parameter is a value that you send into your function. Think of it as 
the opposite of what you get when you return a value from a function: 



Call the tundW 
and send 5.51 as a 




The parameter’s value works just like a variable within the function, except 
for the fact that its initial value is set outside the function code: 
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It w n . . kuOh 

the msg variable is set to 

the^ value P assed '» by the dall 

to send_to_t\wittev-C5. 5/ ’)" 



def send_to_twitter (msg) : 

password_manager = urllib . reguest . HTTPPasswordMgr ( ) 
password_manager . add_password ( "Twitter API ", 

"http : / / twitter . com/ stl 
http_handler = urllib . reguest . HTTPBasicAuthHandler (pas j 
page_opener = urllib . reguest . build_opener (http_handle^ 
urllib . reguest . install_opener (page_opener ) 

params = urllib . parse . urlencode ( {’status': msg} ) 

Download at WoweBook.Com 

resp = urllib . reguest . urlopen ( "http : //twitter . com/ 
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Parameters Lrp Close 



<X 



To use a parameter in Python, simply put a variable name between the 
parentheses that come after the definition of the function name and before the colon. 

Then within the function itself, simply use the variable like you would any other: 

The pavaw>e-lev *a«>e <y>es hev-e- Use the parameter': 

your 



value m 

-Puhe-tiohS Code 
just like any other 
variable- 



def shout_out (the_name) : 

return ( "Congratulations 



+ the_name + " ! " ) 



Later, invoke the function from your code with a different parameter value each 
time you use the function: 



print (shout_out ( 'Wanda' ) ) 

msg = shout_out (' Graham, John, Michael, Eric, and Terry by 2') 
print (shout_out ( 'Monty' ) ) 




Grab your pencil and update your program. Do the following: 

1 . Modify the send_to_twitter ( ) function so that the message text is 
passed into the function as a parameter. 

2. Update your code to make the approriate parameterized calls to 

sent_to_twitter ( ) . 
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ready to tweet 




You were to grab your pencil and update your code to 
incorporate a version of send_to_twitter ( ) that supports 
parameters: 



import urllib . request 
import time 



The variable i h ^e 
todt heeds io become a 
de-f sehd^J^tW"^): of ibe ^ 

dc f sen d_t o_t w i 1. 1 , e r ( ) . \L 



password_manager = urllib . request . HTTPPasswordMgr ( ) 
password_manager . add_password ( "Twitter API " , 



"http://twitter.com/statuses", "...") 

http_handler = urllib . request . HTTPBasicAuthHandler (password_manager ) 
page_opener = urllib . request . build_opener (http_handler) 
urllib . request . install_opener (page_opener ) 
params = urllib . parse . urlencode ( {'status': msg} ) 

resp = urllib . request . urlopen ( "http : //twitter . com/statuses/update . json" , params) 
resp . read ( ) 



def get_price() : 

page = urllib . request . urlopen ( "http : / / www . beans-r-us . biz /prices . html " ) 

text = page . read (). decode ( "utf 8 " ) 

where = text . find ('>$' ) 

start_of_price = where + 2 

end_of_price = start_of_price + 4 

return float (text [ start_of_price : end_of_price ] ) 

price_now = input ("Do you want to see the price now (Y/N) ? ") 



if price_now — "Y" : 

jscirr sehd_io_tWittev-get_pH£eO) 

else: \\ 

h«d h, ^ ep la Ce & e 



price = 99.99 
while price > 4.74: 
time . sleep ( 900 ) 
price = get_price() 

s e «d>>*W u B«Y ) 6~ 



talls with 



pvih-tO 

calls. 
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Tqst DriVq 



Now you’ve amended the program code, it’s time to see if it works. Make 
sure the amended code is in IDLE, and then press F5 to run your program. 

To begin, let’s send an emergency message: 



Python shall 



Eile Edit SheJI Uebug Options Windows 




Python i.l {rJls/a&ViZp Jul U 2005 ^ OHsUH:OB] 

[nc.r. 4.1.1] on limix? 

Type ■copyriqtit" r "credits" or " license [ J " tor more in torraa t ion 
»* - — — — — — — RE5TAET - 

Do yon wont to set the price now (Y/HJT ¥ 

:■ > :■ 




You asked -Pov- ah 
er»e\rgeh£y pHee 
heme i-fc is. 





That worked. But what about the price-watch option...? 
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message received 




Tqst Drove 



comniJQD. 



»> 

Tlhn ymi wnnf tn thr- prirfi nnw jjY/K)? N 

»> I 




You detide "to wait and 
(eventually) the Wet 
with a message to buy 
tomes thru (when the 
pride is right)- 



That works as well. You're ready to go live! 




No ">atte\r where -the 
Stavbuzi CBO is, i-f he 
has his tell nearby, he 
gets -the 

message- 
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there] are no 

Dumb Questions 



% Can I still call the Twitter function like this: send to_ 
twitterO? Or do I always have to provide a value for the msg 
parameter? 



As it's written, the parameter is required by the function. If 
you leave it out, Python will complain and refuse to run your code 
further. 




Can parameters to functions be optional? 



-^1 Yes. In most programming languages (including Python), you 
can provide a default value for a parameter, which is then used if 
the calling code doesn't provide any value. This has the effect of 
making the parameter optional, in that it either takes its value from 
the one provided by the caller, or uses the default value if the caller 
does not provide anything. 




Can there be more than one parameter? 



Yes, you can have as many as you like. J ust bear in mind that 
a function with a gazillion parameters can be hard to understand, 
let alone use. 




Can all the parameters be optional? 



Yes. As an example, Python's built-in print ( ) function 
can have up to three optional parameters, in addition to the stuff to 
print (which is also optional). To learn more, open up a Python Shell 
prompt and type help (print) atthe »> prompt. 




Doesn't all that optional stuff get kinda confusing? 



Sometimes. As you create and use functions, you'll get a 
feel for when to make parameters mandatory and when to make 
them optional. If you look at the description of print ( ) again , 
you'll see that in most usage scenarios print ( ) takes a single 
parameter: the thing to display. It is only when extra, less common, 
functionality is required that the other parameters are needed. 



% The description of print() mentions "keyword 
arguments." What are they? 



The word "argument" is another name for "parameter," and 
it means the same thing. In Python, an argument can have 
an optional "keyword" associated with it. This means that the 
parameter has been given a name that the calling code can use to 
identify which value in its code is associated with which parameter 
in the function. 



Continuing to use print ( ) as an example, the sep, end, 
and file parameters (a.k.a. keyword arguments) each have 
a default value, so they are all optional. However, if you need to 
use only one of them in the calling code, you need some way to 
identify which one you are using, and that's where the keyword 
arguments come in. There are examples of these optional features 
of print () and other such functions later in the book. Don't 
sweat the details right now, though. 
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password changes 



Someone decided to mess with your code 




About time I changed the Twitter 
password. Hmmm... Interesting code, 
but it would be great if it printed a 
message every time it sent a tweet. I 
think I'll just improve it a little... 



One of the Starbuzz coders decided that the password 
should be set at the start of the program, where it can be 
easily amended in the future. This is what she added: 



— 

import urllib . request 
import time 

def set_password ( ) : 

password="C8H10N4O2" This is the new password 

The Coder want to se i -the 
set_password ( ) f" pa^ord at the top of the 
file where it's easy to find- 

def send_to_twitter (msg) : 

password_manager = urllib . request . HTTPPasswordMgr ( ) 
password_manager . add_pas sword ( "Twitter API ", 



"http://twitter.com/statuses", " starbuzzceo" , password) 




(( Wse the value of 
'password" here. 



So, later in the program, the code uses the password 
variable. That means that next time the password needs 
to be changed, it will be easier to find it in the code 
because it is set right near the top of the hie. 
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Tqst Drove 



Add the new password code to the top of the program and then 
run it through IDLE: 



Python shall 



Flip friift r .h**JI r>phur] npfrhnn«i Window* 



I'ytfton J.l UJl: Jul U nHsUHiUB] 

[GC.r. iprL 1 I me a? 

Type ” copyright " F "credit a" or "iiccnac[J" tor do re into mat ion . 
>» ================================ REST&BT 

>» 

Da y □ l: want to □ c nd the pr ic c new is/ [J ) . J S 
Trfl-zebflck (ntoat recent call ^aatl : 

* ** - W- - :J-. »1 nr/rjM.j.r H. E ,y- F 1 ■ nr 15 , : «*nlt 

Flic n ' r.onr da v. dg 1 Dc d kt op , getpr re c -py " F line I z F in send 

"http: y/tv:ti-rr.,-nn iMtnn^V V^rhi>77rrn\ pn™nrHS 
Sidj;id;£j.£.u= : j 1 uL<t 1 Ej^-it 'fdiiKuid 1 lluL Je± I z c-ed 




The program has crashed and it can no longer send out 
messages to the GEO. Stores across the globe are running 
short on beans and it’s up to you to fix the code. 



Look at the error message that was generated when the program crashed. 
What do you think happened? 
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add it to the stack 



The rest of the program can't see 
the password variable 

The program crashed because, for some reason, the program 
couldn’t find a variable called password. But that’s a little odd, 
because you define it in the set_pas sword ( ) function: 



def set_password ( ) : 

password="C8H10N4O2 



,,^-TW.s code sets the ? ass*. 



iov-d- 



set jass.ord ( , ^ THis tod, t(it pass<wd ^ S(i 

def send_to_twitter (msg) : 

password_manager = urllib . request . HTTPPasswordMgr ( ) 
password__manager . add_password ( "Twitter API ", 



This tode uses -the 
passv/ovd... but *fov- 
some reason, i*t tan t | 
see it 



"http://twitter.com/statuses", " starbuzzeeo" , password) 



So what happened? Why can’t the send_to_twitter ( ) 
function see the password variable that was created in the 
set_password ( ) function? 




Programming languages record variables using a section of 
memory called the stack. It works like a notepad. For example, 
when the user is asked if she wants to send a price 
immediately, her answer is recorded against the 
price_now variable: 
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When you call a function, the computer 
creates a fresh list of variables 




L-OCAL variable 
by ihe -Puhd'fcioh 



def set_password() : 

password="C8H10N4O2 " 



This new sheet of paper on the stack is 
called a new stack frame. Stack frames 
record all of the new variables that are 
created within a function. These are known 

as local variables. 

The variables that were created before the 
function was called are still there if the function 
needs them; they are on the previous stack frame. 



Tbe fcdllmj C'O&t s 
variables are still 
here. 



But when you call a function, Python starts to record any 
new variables created in the function’s code on a new sheet 
of paper on the stack: 



Kevi stack tv-ame 



S used 



But why does the computer record variables like this? 



Your program creates a new stack frame each time it calls a function, 
allowing the function to have its own separate set of variables. If 
the function creates a new variable for some internal calculation, it 
does so on its own stack frame without affecting the already existing 
variables in the rest of the program. 

This mechanism helps keep things organized, but 
it has a side-effect that is causing problems... 



When a variable’s 
value can be seen by 
some code, it is said 
to be ’in scope.” 
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local garbage removal 



When you leave a function, its 
variables get thrown away 

Each time you call a function, Python creates a new stack frame to 
record new variables. But what happens when the function ends? 




pile tW.s wdffr 4 tor 



Remember: the stack frame is there to 
record local variables that belong to the 
function. They are not designed to be used elsewhere 
in the program, because they are local to the function. The whole reason 
for using a stack of variables is to allow a function to create local 
variables that are invisible to the rest of the program. 



And that’s what’s happened with the password variable. The first 
time Python saw it was when it was created in the set_pas sword ( ) 
function. That meant the password variable was created on the 
set_pas sword ( ) function’s stack frame. When the function ended, 
the stack frame was thrown away and Python completely forgot about 
the password variable. When your code then tries later to use the 
password variable to access Twitter, you’re outta luck, because it can’t 
be found anymore... 



When a variable’s 
value CANNOT he 
seen hy some code, 
it is said to he 'out 
ol scope.” 



The computer throws away the 
function's stack frame! 
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This is the start of the program. Write a modified version of this 
code that will allow the send_to_twitter ( ) function to see 
the password variable. 

Hint: you might not need to use a function. 




Write you*- hew-^. 
version here. 
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create the password variable 




This is the start of the program. You were to write a modified 
version of this code that will allow the send_to_twitter ( ) 
function to see the password variable. 

Hint: you might not need to use a function. 



import urllib . request 
import time 



def set_password() : 

password="C8Hl0N4O2 " 

set_password ( ) 



You needed *bo rewrite this section. 




def send_to_twitter (msg) : 

password_manager = urllib . request . HTTPPasswordMgr ( ) 
password_manager . add_password ( "Twitter API", 

"http://twitter.com/statuses", " starbuzzceo" , password) 
http_handler = urllib . request . HTTPBasicAuthHandler (password_manager ) 
page_opener = urllib . request . build_opener (http_handler) 
urllib . request . install_opener (page_opener ) 
params = urllib . parse . urlencode ( {'status': msg} ) 

resp = urllib . request . urlopen ( "http : //twitter . com/statuses/update . json" , params) 
resp . read ( ) 



This is all you need bo do ■ just 
create the variable. 

•V 

password^CSttl ON^OZ” 



Because the "passed" variable * seabed 

outs.de a Wtion, it is available ay here 

^i,the ? ^.TheV«d>>.tW) 

Utbon Should »ow be able to see it- 
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Tost Drove 



The fixed version of the code has been loaded onto machines 
in every Starbuzz store worldwide. It’s time to try out the code 
and see if you can get the ordering system working again: 




Python shall 



Die Edit EiheJI Ltebug Options Windows 



Help 



Suve enough, the e^er^cnt'j 
ovdev prite yb 



Python 3.1 {rdlt IdSI2, Jul b OB:Ub:OB) 

[CrC.r. 4.1,1] on linux? 

Type “copyriqtit" r "ciediCB" or "licensef ) " tor rwsre information . 
»> RE5TAET 

JV>.> 

Do yon wont to sot the price now i| Y/KJ ? Y 



It works! Because you are creating the password outside 
of a function, it is available globally throughout the Python 
program file. The password variable will be recorded against 
the initial stack frame, so the send_to_twitter ( ) function 
will now be able to see it. 



Let's see how the updated code is affecting 
the rest of Starbuzz. 
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full of beans 



Starbuzz is fully stocked! 




f““ k»«fc 

a S ^mny lai{ e ? 



Mth -the CoW« teans tuIN 
stocked, W* floty W 

■tke more imyortaint. ttowy m u« - • and there are a lot 

o+ happy Starb UZi 

Customers, -fc oo. s 



From Cambridge to Cambodia, from Seattle to Sierra 
Leone, the orders are being placed and the beans are 
being delivered. 

You did a great job. Your system tracks live prices from 
the Web and automatically sends messages to the CEO 
wherever he is on Earth. You are really using the power 
of functions to keep your code clean, concise, and 
clear. By correctly using variable scope, you even made 
it easy to keep the password up-to-date. 
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Your Programming Toolbox 

You've got Chapter 3 under your 
belt. Let's look back at what 
you've learned in this chapter: 






TooU 



•Uv £wfct*ov> s - 

* ** 

* ^ a " d 
, l„ s *«* f rt ” 

*** a WW. a ^ ^ **** 

* W\>Cn ^ ta (V ,L. orv \p ^C- 

^ W u , 0 tt*** 

* sta* * ra " l a Vs 

-L wW*—* 

* fi <av«' t ' e ,s ^. e toi«- 



to Create -functions. 

* Use ^rhO -to send a value 
back to the Code that called the 
TUh^ioh. 

* Pass parameters to Junctions by 
placing them between parentheses. 
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4 delta !n ¥!les and arrays 



# Sort it out + 




As your programs develop, so do your data handling needs. 

And when you have lots of data to work with, using an individual variable for each piece 
of data gets really old, really quickly. So programmers employ some rather awesome 
containers (known as data structures) to help them work with lots of data. More times 
than not, all that data comes from a file stored on a hard disk. So, how can you work with 
data in your files? Turns out it’s a breeze. Flip the page and let’s learn how! 
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waiting for the waves 



Surf's up in Codeville 

The annual Codeville Surf-A-Thon is more popular than ever 
this year. 

Because there are so many contestants, the organizers asked 
you to write a Python program to process the scores. Eager to 
please, you agreed. 

The trouble is, even though the contest is over and the beach 
is now clear, you can’t hit the waves until the program is 
written. Your program has to work out the highest surfing 
scores. Despite your urge to surf, a promise is a promise, so 
writing the program has to come first. 




TKe stoveboavd is 

Wafs 



Chapter 4 



Surf-A-Thon 
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Find the highest score in the results file 

After the judges rate the competitors, the scores are stored in a file called 
results . txt. There is one line in the file for each competitor’s score. You 
need to write a program that reads through each of these lines, picks out the 
score, and then works out the highest score in the Surf-A-Thon. 





It sounds simple enough, except for one small detail. You’ve written programs 
to read data from the Web, and read data that’s been typed in at the keyboard, 
but you haven’t yet written any code that reads data stored in a file. 
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shredding with the for loop 



Iterate through the file with the open, for, 
close pattern 

If you need to read from a file using Python, one way is to use the built-in 
open ( ) command. Open a file called results.txt like this: 

The opened % * ft* f^l of 

• e di -to a tile handle, result_f = open ( " results . txt " ) the tile to 0 p tfh ^ 

t&i V «Hj* ^ ^ 

The call to open ( ) creates a file handle, which is a shorthand that you’ll 
use to refer to the file you are working with within your code. 

Because you’ll need to read the file one line at a time , Python gives you the for 
loop for just this purpose. Like while loops, the for loop runs repeatedly, 
running the loop code once for each of the items in something. Think of a 
for loop as your very own custom-made data shredder: 

|v/ote : unlike a real 
shredde*-, -the tor loop 
shredder™ doesn’t 
destroy your data it 
just chops it into lines. 

y 



•••whidh breaks it up into one- 
line— at— a— time dhunks (whidh are 
-themselves strings). 



The entire -file is 
-fed into the -for loop 
shredder- 





The for loop shredder™ 




Each time the body of the for loop runs, a variable is set to a string 

containing the current line of text in the file. This is referred to as iterating * 

through the data in the file: 0\tr\ the ti e an <yve 

it a -file handle. 

result_f = open ("results .txt") 

Do something with the thm* you’ve \ust read W 
the -file. In this ease, you print out the line. Notice 
print (each_line) ^ .for loop s dode is indented- 



The w eadhJine ,J ' variable is 
set to the ne*t line -from, 
the £ile on eadh iteration. 
The -for loop stops when 
you run out o-f lines to 
read- 



for each_line in result_f : 



result_f . close ( ) 



Close the -file (through the -file handle) 
when you re done with it* 



116 Chapter 4 



Download at WoweBook.Com 



data in files and arrays 



i 



Code Magnets 

You need to complete the code to find the highest score in the 
results . txt file. Remember: the for loop creates a string from 
each line in the file. 

Hint: For the program to work, you will need to convert the string 
into a number. 



highest_score = 0 

result_f = open ( "results . txt " ) 

for line in result_f : 

if ( ) 

( ) 

result_f . close ( ) 

print ("The highest score was:") 
print (highest_score) 




you are here ► 
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getting the highest score 




Code Magnets Solution 

You needed to complete the code to find the highest score in the 
results . txt file. Remember: the for loop creates a string from 
each line in the file. 

Hint: For the program to work, you needed to convert the string into 
a number. 



Remember *to 
indent *tbe £ode 

inside tbe loop ANP 

aaain inside *tbe 
statement 



highest_score = 0 

result_f = open ( "results . txt " ) 

for line in result_f: 

float | ^ I liixc | ^ 




float^ ^ J 


line 


1 highest^ 


score 1 



result_f . close ( ) 
print ("The highest score was:") 
print (highest_score ) 

T, . . 

Atu. to. i~? •*&*■-?* 

wubk to* toe to«t 

aato We. *> 7“ **“ V 3 ~* 4 f 1 

it on Screen. 




The "highest _stove" variable gets 
updated every "time you rind a line -that 
don-tarns a higher sdore- 

v? 



Remember -to donvert the string to 
a number with -PloatO. Even though 
the line is a number, it domes into 
the program as a string. 




To successfully run this program, you need to grab a copy of the results . txt 
data file from the Head First Programming website. Be sure to put the data file in 
the same directory (or folder) that contains your code. 
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Drove 



It’s time to see if the program works. Use IDLE to create a new file using the code 
from the previous page, save your program as high_score . py, and then run it by 
pressing the F5 key: 



hlgh_£G0ra r py - /homaybiriYF/HaadFEr&rProg; * - 



Eile Edit fermat nun Qptions Windows 



!iiqhe3t_acore = 0 

rcau±t_l - opcn( 'rcaulta .tJrt" ] 

for line in reault_i: 

Hurl I fliiih*) > It L lj I ii^m I Msitirrf: 
niqUest_gcore = float \ Line } 
maul t_f. clone ( > 
print ("The highest score wbs: h |i 

in Ini pi i rjhnn I. he:i hr m ) 



I 

I L<i 




I* 0 * * the pvogva* 

jyped into IP LB. 



Python shah 



Eile Edit EiheJI Uebtjg Qptions Windows 



Help 



Python 3.1.1 | rill: 74480, &nq IS 2009 r D1:03i43| 

[Gee i.j.jj on linuxiZ 

Type " copyr ight " F "credits" or p Liccnnc()" for more information. 



OK Y\o, sometWj 

<y>Y\t south hev-e • 



s 



Tracehac* (moat recent call last): 

File " Thorne.' borryp; EtDadFirotProg/ chapter^ /code i i 'high_30orc,py " , line 4, 



i f f ' 1 nnt ( 1 i iwj J > hi ghr st nrafnrti : 

VdlutrE-LEUiE : nut ujuveiL s-Ll_:.u Lu ILuaL: Juluuiy 8 . S3 




* 



in <noduLc> 



I n: 1 Osfjnl 



Oh dear. It looks like something’s gone wrong! The program has 
crashed with aValueError, whatever that is. 



Look's like you are trying 
to donvert something that 
didn’t look like a number. 







1? 



Study the error message produced by Python. Is there something wrong with 
the Python code? Is there a problem with the file? Is there something wrong 
with the data? What do you think happened? 
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fr %i 




names and numbers 



The file contains more than numbers... 



To see what happened, let’s take another look at the judge’s score sheet 
to see if you missed anything: 




There are -two pieces 
o( i^-Pormatioh oh 
eaeh I me-- a name ahd 
a number (the surfer's 
sdore). 



The judges also recorded the name of each surf contestant next to his or 
her score. This is a problem for the program only if the name was added 
to the results.txt file. Let’s take a look: 



The 

file. 




The 

look 



Sure enough, the results . txt file also contains the contestant names. 
And that’s a problem for our code because, as it iterates through the file, 
the string you read is no longer just a number. 



resul-fcs ih 

like -this. 



"the -Pile 
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Split each line as you read it 

Each line in the for loop represents a single string containing two 
pieces of information: 



Johnny 


8.65 


Juan 


9.12 


Joseph 


8.45 


Stacey 


7.81 


Aideen 


8.05 


Zack 


7.21 


Aaron 


8.31 



;\>x 



Brad 


4.03 




Jim 


7.91 






Each I'me contains a name and a 
as a string 




.V. -wv, w 

£ut eaeh line m two- 



You need to somehow extract the score from the string. In each 
line, there is a name, followed by a space, followed by the score. You 
already know how to extract one string from another; you did it for 
Starbuzz back in Chapter 2. And you could do something similar 
here using the f ind ( ) method and index manipulation, searching 
for the position of a space ( f ') character in each line and then 
extracting the substring that follows it. 

Programmers often have to deal with data in strings that contain 
several pieces of data separated by spaces. It’s so common, in fact, 
that Python provides a special string method to perform the cutting 
you need: split ( ) . 



Python strings have a built-in split () method. 



f[v\d you II -Cind that other 

larges have very 
similar mechanisms tor breaking 
strips. 
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split the string 



The split!) method cuts the string 



Imagine you have a string containing several words assigned to a variable. Think 

ft variable, a 

A single variable is assigned- ^ -a single string, which W *' ed ^ 

£onx3ins -four words. 



rock_band = ”A1 Carl Mike Brian” 

.. .. \ 



The rock_band string, like all Python strings, has a split ( ) method that 
returns a collection of substrings: one for each word in the original string. 




A s-fcring, 
£°>vfcai hcd 
ih a variable 
0 aO- 



Using a programming feature called multiple assignment, you can take 
the result from the cut performed by split ( ) and assign it to a collection of 
variables: 



The lett side o£ the 
assignment of er 3 tor lists ' 
the variables to assi gn 
values to. 



(rhythm, lead, vocals, bass) = rock_band. split () 



t 



The right side ot the 
assignment operator 
eontains the eall to 
the splitO method- 




stringed value. 



Each of the return values from the split ( ) on rock_band is assigned to its 
own separately named variable, which allows you then to work with each word in 
whatever way you want. Note that the rock_band variable still exists and that it 
still contains the original string of four names. 



Looks like you can use multiple assignment and split () to 
extract the scores from the resuits.txt file. 
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ExenciSe 



Here is the current version of the program: 



highest_score = 0 

result_f = open ( "results . txt " ) 

for line in result_f : 

if float (line) > highest_score : 
highest_score = float (line) 
result_f . close ( ) 

print ("The highest score was:") 
print (highest_score) 



Write the extra code required to take advantage of the split o method and multiple 
assignment in order to create variables called name and score. Then use them to complete 
the program to find the highest score. 
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find the top score 




BtendSe 

Solution 



Here is the current version of the program: 



highest_score = 0 

result_f = open ( "results . txt " ) 

for line in result_f : 

if float (line) > highest_score : 
highest_score = float (line) 
result_f . close ( ) 

print ("The highest score was:") 
print (highest_score) 



You were to write the extra code required to take advantage of the split o method and 
multiple assignment in order to create variables called name and score, then use them to 
complete the program to find the highest score. 



W+k'i x spl,t0 
( t° Cut the ,» e m two, dreatmg h 

. , , . r . P "*•* V tables. 

The only tode than^es ^ tor |* mc m vesul*t__r : / 

required are within the j 

-fov I oof. The rest o*f (name, store) =• linesplitO **- 

the program remains r r . . , . . . , 

unthanyd- .'l 

/ hijjtastjsdore => -float(store) 

You are no longer 
tomparin^ the line to 
the highest store, so 
be sure to tompare the 
“store” variable instead- 
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Tqst DRive 



So what happens when you run this version of the code within IDLE ? Let’s 
amend the code and see: 



hlgh_«ore2.pY - /horn a/barryp/HGadF Erst P rag i + - k 



£iIp Trlit format Run Opt inn >i Wind a 



JiiqhaBt_acors - 0 

rcculfc_f - open ( "results -tut" ) 

■ 1 inr r^niil t. f : 

( naac, score] = Llne.aplitf] 
it lloat (score] > ni gtieBt_score : 
higbest_acorc - float (score] 
rraul l f.izlnnr ( j 
print {"Ttie highest anore vasE"] 
print [tiLgncot_ccDrc \ 




U>e amended Code, which 
takes adva^ 9e ^ the 
fhiO method. 



This time, the program 



pv-oduCes a vesult you 
tan actually use. 




It works! The program reads each line from the file as a string, extracts the 
score using the split ( ) method, and then uses it to find the highest score 
in the file. The organizers are so excited to hear that the program is finished 
that they immediately display the result on the large scoreboard at the back 
of the beach. 






more top scores 



Put you need more than one top score 



As soon as the top score appears, people start to wonder what the 
second and third highest scores are: 



You ave missing some 



nd 



stoves heve • ike 2-' 
and 3*^ stoves ave a 
mystevy- 




It seems that the organizers didn’t tell you everything you 
needed to know. The contest doesn’t just award a prize for the 
winner, but also honors those surfers in second and third place. 




Our program currently iterates through each of the lines in the 
results . txt file and works out the highest score. But what it 
actually needs to do is keep track of the top three scores , perhaps 
in three separate variables: 



Looks like you need e%*bra 
vaviables £ov *bke second and 
-thivd Widest stoves. 
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Keeping track of $ scores makes the code 
more complex 

So how will you keep track of the extra scores? You could do something 
like this: 



This is HOT veal 
Pythoh dode. It's what — 
pvogvanMwevs call "pseudo- 
code- They use it when 
they ave sketching out 
ideas and wovking out a 
pn-ogvam's logic. 



set the highest_score to 0 
set the second_highest to 0 
set the third_highest to 0 
iterate through each of the scores: 
if the score > highest_score : 

set the third_highest to second_highest 
set the second_highest to highest_score 
set the highest_score to score 
otherwise if the score > second_highest : 

set the third_highest to second_highest 
set the second_highest to score 
otherwise if the score > third_highest : 
set the third_highest to score 




You can see that there’s a lot more logic here, because the program needs 
to “think” a bit more. Unfortunately, turning this logic into code will 
make the program longer and harder to change in the future. And, let’s be 
honest, it’s somewhat more difficult to understand what’s actually going 
on with the logic as shown here. 



How could you make this simpler? 

Sharpen your pencil 



Think about what would make the program easier to write. Check 
the box that you think would have the greatest impact: 



| | If there were no names in the file, only numbers | | If the data were ordered highest to lowest 

1 1 If the scores came before the names in the file | | If you knew exactly how many lines are in the file 
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sort the data 



You were think about what would make the program easier to 
write and check the box that you think would have the greatest 
impact: 




1 | If there were no names in the file, only numbers 




were ordered highest to lowest 



I I If the scores came before the names in the file 



1 | If you knew exactly how many lines are in the file 



An ordered list makes code much simpler 




If you had some way of reading the data from the file and then producing an ordered copy 
of the data, the program would be a lot simpler to write. Ordering data within a program 
is known as “sorting:” 



The -top -three stores are \ust 
■the -first three values in the 
sorted data, extracted to 
variables. £asy! 



An ordererd (or 
sorted) top y of 
the same data 



The unsorted data 

l 



8 , 


. 65 


9 . 


. 12 


8 , 


.45 


7 . 


81 


8 , 


.05 


7 . 


21 


8 , 


.31 





But how do you order, or sort, your data? What happens to the original data 
in the file? Does it remain unsorted or is it sorted, too? Gan the data even be 
sorted on disk and, if so, does this make things easier, faster, or slower? 

Sorting sounds tricky... is there a "best" way? 
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Sorting is easier in memory 

If you are writing a program that is going to deal with a lot of data, you 
need to decide where you need to keep that data while the program works 
with it. Most of the time, you will have two choices: 

Keep the data in files on the disk. 

If you have a very large amount of data, the obvious place to put it is on 
disk. Computers can store far more data on disk than they can in memory. 
Disk storage is persistent: if you yank the power cord, the computer 
doesn’t forget the information written on the disk. But there is one real 
problem with manipulating data on disk: it can be very slow. 

Keep the data in memory. 

Data is much quicker to access and change if it’s stored in the computer’s 
memory. But, it’s not persistent: data in memory disappears when your 
program exits, or when the computer is switched off (unless you remember 
to save it to a file, in which case it becomes persistent). 



© 



© 



Keep the data in memory 

If you want to sort a lot of data, you will need to shuffle data around 
quite a lot. This is much faster in memory than on disk. 



You have lots O-P lines of 
data, so you II need lots of 
variables... right?/? 




Of course, before you sort the data, you need to read it into memory, 
perhaps into a large number of individual variables: 



You need to "' ove 

-the lines of data 

in the results- t*t 

f ile into n>en'OV'/ 
before tv-yin°) to 










You are going to have a problem if you attempt to move all those 
lines of data into the computer's memory. What type of problem do 
you think you'll have? 



e a hiOy 
? Betause that s 
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too many variables 



You can't use a separate variable 
for each line of data 



Programming languages use variables to give you access to data in 
memory. So if you are going to store the data from the results . txt 
file in memory it makes sense that you’ll need to use lots of variables to 
access all the data, right? 

But how many variables do you need? 

Imagine the file just had three scores in it. You could write a program 
that read each of the lines from the file and stored them in variables 





Sometimes, you need to deal with a whole bundle 
of data, all at once. To do that, most languages give 
you the array. 
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But what if there were four scores in the file? Or five? Even worse, what 
if there were 10,000 scores? You’d soon run out of variable names and 
(possibly) memory in your computer, not to mention the wear and tear 
on your fingers. 



Well, the As are done 
and that's the first volume 
of all the entries from the 
Encyclopedia Galactica stored 
in memory. Time to tackle the 
B s, then the Cs, Ds, Es.... 



data in files and arrays 



An array lets you manage a whole train of data 




Think of an array as a data train. Each car in the train is called an 
array element and can store a single piece of data. If you want 
to store a number in one element and a string in another, you 
can. 



Here domes -the 

data tv-aim 



£adh dar holds 

a single ^iede ok 
data- 



So far, you’ve used variables to store only a single piece of data. But 
sometimes, you want to refer to a whole bunch of data all at once. For 
that, you need a new type of variable: the array. 



An array is a “collection variable” or data structure. It’s designed to 
group a whole bunch of data items together in one place and give them 
a name. 



You might think that as you are storing all of that data in an array, 
you still might need variables for each of the items it stores. But this is 
not the case. An array is itself just another variable , and you can give it 
its own variable name: 




Even though an array contains a whole bunch of data items, the array 
itself is a single variable , which just so happens to contain a collection of data. 
Once your data is in an array, you can treat the array just like any other 
variable. 



So how do you use arrays? 
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create and extend an array 




Python todevs typitally use the wovd array to 

move dovvedtly vefev to a list that donta'ms only 
data of one type, like a bunth of string ov a 
bunth of numbevs. And Python domes with a built- 
in tedhnolooy dalled "away" fov just that puvpose- 
However, as lists are very similar and mudh more 
flexible, v/c pv-e-fer bo use *bbew\, so you don *b need 
-bo worry about this distinction -for now. 



my_words = ["Dudes", "and”] 

t ^ 

^ive the / Assign a list 

array a name. of va | ues ^ ^ 



This creates a two-item array and gives it the name my_words. 
To look at individual items in the array, index the element 
required: 

>>> print (my _words [ 0 ] ) 

Dudes 

>>> print (my _words [ 1 ] ) 



Python gives you arrays with lists 



Sometimes, different programming languages have different 
names for roughly the same thing For example, in Python most 
programmers think array when they are actually using a Python 
list. For our purposes, think of Python lists and arrays as the 
essentially same thing. 

You create an array in Python like this: 



and 



You can read individual pieces of data from inside the array using an 
index, just like you read individual characters from inside a string. 

As with strings, the index for the first piece of data is 0. The second 
piece has index 1, and so on. 



Arrays can be extended 

But what if you need to add some extra information to an array? 

Like strings, arrays come with a bunch of built-in methods. Use the 
append ( ) method to add an extra element onto the end of the array: 
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>>> my _words . append ( "Bettys " ) 
>>> print (my_words [ 2 ] ) 

Bettys 



The away has gvown 
by one data element- 



data in files and arrays 




high scores in the array 




You were to rewrite the program so that each time you read a 
new score you append it to the end of an array called scores. 

You were then to amend the code to print out the first 3 scores in 
the list. 



Here s the tode as 
it Currently stands. 



highest_score = 0 

result_f = open (" results . txt " ) 

for line in result_f : 

(name, score) = line. split () 
if float (score) > highest_score : 
highest_score = float (score) 
result_f . close ( ) 

print ("The highest score was:") 
print (highest_score) 



Start with an 
empty array. 

stores =■ □ 

0 fl , , result_t — open(Vesults.t*t”) 
Process the data in 

the tile as be-Pore... --^tor line in vesult^t- 

(name ; store) — linesplitO 



-but; this time; append the ^ sdores.appendtfloatfsdore)) 
stores to an array. 

result -PdloseO 



prints u The top sdores were- ; 0 

print(s£oresC03) 

VVith the data sa-Pely J print(s£oresCI3) 
stored in the array; j 
print out the -f irst 3 y print(sdoresC2J) 
array elements. ^ 
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Tost Drove 



The program should now store all of the information from the file into 
the scores array before displaying just the top three scores. Let’s run 
the program within IDLE and see what happens: 



htgh «o r* arrayt.py ■ /home/barryp/H + 



Die Ldjt farmfll Bun Options Windows 



score 0 — | 
rc3ult_f - 
lice , 
( name , 



r 

open { m res ult 

result_f 3 
score) - line 






Python shall 



scores . append ( float 
rcoult_f .cloned ) 

|ir i ist. ( "Tin- t-£ip jis : i □ r t -: m mi 

print ( scores [ U J ) 
pr l Tit ( fiirorr.i [ 1 J J 
orint ( scores \ 2 \ ) 

I 



File rrlrt r.hell JVhug nplmn^i Window 1 ! 



I'ytfton i.i.i (rills J 44 HU F Aug US iiuuy. U/sUis-Si) 

[GC.r. 01 _ ?L _ 3 | [Ml 1 i run? 

Type "copyright", "crsditB" or "license ()" tor evore iniorraa t ion . 

>» RTISTART 

>.» 

Thr trip .irnTM -wtr-Triz 

a. 63 
9.12 
a. 43 

»>i 



TKe tode ^odu«s -tV>ese 

«aJts, ^ ^ asK 

-the seoveboav-d 




Surf-A-Thon 




l. 8.65 
Z . 9.18 

5. 8.45 



Crap. The program is printing out the 3 scores all right, but it’s not 
printing out the top 3 scores in order, and there’s confusion about who 
won. 



•XJ*' WAN* 



Which important step did the program forget to perform? 
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Sort the array before 
displaying the results 



The array is storing the scores in the order they were read from the file. 
However, you still need to sort them so that the highest scores appear first. 




You could sort the array by comparing each of the elements with each of 
the other elements, and then swap any that are in the wrong order. 



cs ,h the array are 
ih a random order. 



That looks complicated. Aren't 
we doing all this to make the 
code simpler and easier to maintain? 
I wonder if the array has any built- 
in methods that might help...? 



By closely examining -the array 
or boxes, you ean sor-i -them by 
arraying -the boxes in bigges-t- 
-to-smalles-t order. 



O 



Arrays in Python have a whole host of methods that make 
many tasks easier. 

Let's see which ones might help. 
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7 * 



These are some of the methods that come built into every array. See 
if you can match up the descriptions with the method names. Draw in 
the missing connecting lines. We’ve done one for you to get you started: 



Method 



Vfidt the method does 



count ( ) 
extend ( ) 
index () 
insert ( ) 
pop () 
remove ( ) 
reverse ( ) 
sort ( ) 



Sorts the array into a specified order (low to high) 

Removes and returns the last array item 

Adds an item at any index location 

Looks for an item and returns its index value 

Reverses the order of the array 

Tells you how many times a value is in the array 

Adds a list of items to an array 

Removes and returns the first array item 




Can you work out which two methods you need to employ to allow 
you to sort the data in the order that you need? 
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sort then reverse 






+ 



* 



n<v 

These are some of the methods that come built into every array You 
were to match up the descriptions with the method names: 



Method 




Vlictt the method does 

Sorts the array into a specified order (low to high) 

Removes and returns the last array item 

Adds an item at any index location 

Looks for an item and returns its index value 

Reverses the order of the array 

Tells you how many times a value is in the array 

Adds a list of items to an array 

Removes and returns the first array item 







You were to work out which two methods you needed to employ to 
allow you to sort the data in the order that you needed. 

The sort () and reverse () methods look the most useful. You 
need to use reverse ( ) after you sort ( ) the data, because the 
default ordering used by sort () is lowest-to-highest, the opposite 
of what you need. 
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Sort the scores from highest to lowest 

You now need to add the two method calls into your code that will sort the 
array The lines need to go between the code that reads the data into the list 
and before the code that displays the first three elements: 




The array starts a ra*>do«> 
order. It's "wworted " 



- . Sharpen your pencil 



Here is the existing program. Add in the missing code that sorts 
the data, highest-to-lowest. 



put the e*tva 



to de hev-e. 



scores = [] 

result_f = open ( "results . txt" ) 
for line in result_f: 

(name, score) = line. split () 
scores . append (float (score) ) 
result_f . close ( ) 



print ("The top scores were:") 
print (scores [0] ) 
print (scores [1] ) 
print (scores [2] ) 
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all sorted out 





A-Ptcv the eall to so\ri() ahd 
reverseO, the array is sorted 
lh the order you heed. 




(jeejc Bf£$ 

It was very simple to sort an array of data using just two lines of code. But it turns out you can do even 
better than that if you use an option with the sort ( ) method. Instead of using these two lines: 

scores . sort ( ) 
scores . reverse ( ) 

you could have used just one, which gives the same result: scores . sort (reverse = True) 
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Tost DriVq 



Update your program in IDLE and run it. Look what happens: 



h Iq h_ccoro_a rraytGO rtod . py ■ /h om e/b ar + 



Eile Edrt farmst Bun Options Windows 



scores - [ j 

rr^ti 1 ti f a nprtn^ tin . t.Tct-" J 

for line in .re3uit_fs 

£ name F score ) - li ne ■ aplit-t j 
scores _ append ( rioaiF 
rcou lt_f . clos c \ ) 



UHp B The additional Code enures the 

res ^ aire "the order you heed. 



Python shell 



scores . oe>rt{ ) 

HnirKfi. Mfvcr.n:( ) 

|*r i nt. ( “Tilt- I if[j -lirciTen 
print £ scores \U\) 

pri Til - £ [ 1 ] jj 

nrint £ scores \2\) 

l 



E^le Edit SheJI Debug Options Wmdows 



Pytfron J.i.i (rill: M44KJ, Aug IB ^ 00 y F 
[GC„r. 4.1.11 nn HniiJi? 

Type “copyriqnt" j "credits" or "license!) J " lor Eiore intonation. 
»> — — RESTART ■ — 



T he top scores wre; 
9.12 
B . &5 ¥ 

B.4L3 ' 



Looks mutk better! 



The program works great! 





The scores are in descending order, and the program is really not much longer 
than when it found just one score. Using arrays allows us to solve a much 
harder problem with very little extra code. And instead of using lots of 
complex logic and lots of variables, you have straightforward logic and only 
one variable: the scores array. 





scores without names 



And the winner is...? 

It’s time for the award ceremony. 

The prizes are lined up and the scores are on the scoreboard. 
There’s just one problem. 

Nobody knows which surfer got which score. 




1 . 9.18 

8 . 8.65 

3 . 8.45 



r 
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urf-A-Thon 



Vow know tke winning 
Stoves, but -tbe winnn^ 
suvtevs ven>3in 3 mystevy— 



Winners 
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You somehow forgot the surfer names 

With your rush to catch some waves before the light is gone, you forgot 
about the other piece of data stored in the results.txt file: the 
name of each surfer. 

Without the names, you can’t possibly know which score goes with which 
name, so the scoreboard is only half-complete. 

The trouble is, your array stores one data item in each element, not 
two. Looks like you still have your work cut out for you. There’ll be no 
catching waves until this issue is resolved. 



You ton-^o-t b 
^vodess the 

n3w\£S. 



1 rr n 


'* 1 


uixrrie 


score 


johnny 


8.<«S 


Juan 


9.12. 


Joseph 


8.4S 


Stacey 


7.81 


mdleen 


8.05 


£acK 


7.21 


«aron 


8.31 



How do you think you 
can remember the names 
and the scores for each 
surfer in the contest? 

Once you’ve thought 
afoul this problem, turn 
over to Chapter 5 and 
see if you can resolve 
this issue. 
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CHAPTER 4 



programming toolbox 




Your Programming Toolbox 

You've got Chapter 4 under your belt. 
Let's look back at what you've learned 
in this chapter: 






* Wes - reaM Aat3 ^ We ^at 

a toWetW 



* avva'f 5 

data ’ 

irvdc'i'- 

evdcv 






i s^et'^ 



awarv^ 1 



Python Tools 

* o P Ch0 - «r°> * -file -for pressing 
^ ^loscO — dlosc a -file 

* for - iterate over sometWj 

pa ^ in, SpW0 ■ c “* J *"”5 i»<» ~ltipl« 

* H - tke away index operator 

* *"W»aO - add ax ife. to tKe end of 
array 

higheir SO,r ^ 0 " *** ** ***** lowes ^-t°- 

* arrayreverseO - change the order of a, 
array by reversing i-t 
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# Putting data ^ 
+ in its place 



Arrays aren’t the only show in town when it comes to data. 

Programming languages come with other data-arranging goodies too, and our chosen tool, 
Python, is no exception. In this chapter, you’ll associate values with names using a data 
structure commonly called the hash (better known as dictionary to Python-folk). And when 
it comes to working with stored data, you’ll read data from an external database system 
as well as from regular text-based files. All the world’s awash with data, so turn the page 
and start applying your ever-expanding programming skills to some cool data-processing 
tasks. 
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still looking for a winner 



Who won the surfing contest? 



In the previous chapter, you worked out the top three scores, 
but they’re not much use without the names of the surfers that 
achieved those scores. There will no be surfing for you until 
you’ve finished the program. 




Winners 



Here’s the code so far: 



— 

scores - [] 

result_f = open ( "results . txt " ) 
for line in result_f : 

(name, score) = line. split () 
scores . append (float (score) ) 
result_f . close ( ) 
scores . sort ( ) 
scores . reverse ( ) 
print ("The top scores were:") 
print (scores [0] ) 
print (scores [1] ) 
print (scores [2] ) 
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Rewrite your current program to use two arrays: one to keep 
track of the scores, the other to keep track of the surfer names. 
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two arrays 



k Solution 



You were to rewrite your current program to use two arrays: one 
to keep track of the scores, the other to keep track of the surfer 
names. 



stores =. [3 



names — [3 



vcsul-t 4* =■ open(Vesultst*t”) 

-for line in result_£ : 

(name, store) =■ linesplitO 
stores.appendtfloat(store)) 
names.append(name) 
result_£doseO 
stores.sortO 



stores.reverseO 

t. -4 ^.^0 

names arr ay* 

names.reverseO 



print( u The highest scores v/ere : ”) 
print(namesC03 + 1 v/ith * + str(storesC03)) 
print(namesCI3 + 1 with * + str(storesC) 3)) 
print(namesC2J + 1 with * + str(storesC2J)) 



Append the surfer s name 
to the names away. 



As well as the stores 
array, you * cc< ^ 
a names array, too. ~ 



r L«afl iW 



Don't forget to download results . 
txt from the Head First Programming 
website before continuing. 
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Tost Drii/q 



With the results . txt file saved to the same directory as your program, enter this 
code into IDLE and see what happens. Remember to save your program, then press 
F5 to run it. 



tilgh_fiearG_2_a.iTays.py - /hem sad F Fret Pro^/chapt * - n v. 



£j|f* frlit ffirmRfr Run Qjitinn^ Windfiw 1 ! 



J>lp 



scores - | J 
nriintfn = [ J 

result;_r — openp 1 sreauite . tKt " ) 

linn r«r: mil It: fi 

(name, score J — line . split ( p 
score a . append ( flout i score ) ) 
n aines . appe nd [ name J 
re a ult_f * c lose ( ) 

seorcc.oort^ ) 



jmjrifs . au 1. 1. ( J 
names . reverse ( ) 

print [ " Tiie highest sco 

JI-3 i ill ( Eferirni-! M j 0 ] t W 

print [ r.ar.oa | 1 1 + wit 

pr i vit ( | ? ] ! " w: ■- 



These results <W-fc make 



sense* 



Python Shalt 



Eile Edit &hejl Uebug Options Windows 



Python J.UI (rills rilVtif Auq IB ^wuy p U^sUJ:4!>] 

| G CC 4.3.3] on 1 i nuxZ 

Type “ copy riq tit" r "credit a" or " license ( j " tor, 

»> , . REST AFJZ 

>> j 

The hi cheat scorca were: 

IdL-t with 9.12 
Stacey with B.&3 
Jlurtai with a .. 4- n 
>» | 



<£ore inrormacion . 




Those results look a little strange. Zack is only a novice surfer but, according 
to the results from your program, Zack has the highest score. It looks like the 
association between the surfer names and their scores is somehow lost... and if 
you think about it, this is exactly what’s happening. 

The two arrays are independent of each other: one contains scores, the other 
names. When the data is in the file, the surfer name and the scores are associated 
with each other because they appear on the same line. However, once the split 
occurs and the data is in the arrays, the association is severed. Sorting one array 
has no effect on the ordering of the other. No wonder your results are a little off 
the wall. 



How do you fix this? 
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need a new data structure 



Associate the name with the score 



Using two arrays just won’t cut it. You need some other data structure to hold 
your data in such a way that the association between the surfers’ name and their 
score is maintained. 



Here's -t he 
array of 
sorted 
stores- 



9.12 


I 


Zack 


8.65 




Stacey 


8.45 




Juan 


8.31 




Joseph 


8.05 




Johnny 


7.81 




Aideen 


7.21 




Aaron 









rN 



•' -dhd hare's 
ihe away 
soried 
names. 



stamen 



But ihe stoves no lor^ev 
matth ihe names! 



lA/hat you need 

something that 

looks like this. 




Many vows 

oi data 



You need a different data structure. But which one? 



Scholar’s Comer 



£*aetly -two 

Columns of 

matched data 




Data Structure standard method of or^aniz-in^ a 
Collection of data items in your Computer's memory. 

You've already met one of the classic data structures; 
the array- 




1 50 Chapter 5 
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Match the data structure names on the left with their descriptions on 
the right. We’ve already done one for you. Which one do you think 
you’ll need to use for the surfer data? 



Array 



A variable that allows data to enter 
at one end of a collection and leave 
at the other end, supporting a first-in, 
first-out mechanism 



Linked list 



A variable that contains data arranged 
as a matrix of multiple dimensions 
(but typically, only two) 



Queue 



A variable that has exactly two 
columns and (potentially) many rows 
of data 



Bast 



* A variable with multiple indexed slots 
for holding data 



Set 



A variable that creates a chain of data 
where one data item points to another 
data item, which itself points to 
another data item, and another, and 
so on and so forth 



Mukrtliniensional array 



A variable that contains a collection 
of unique data items 
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hash it out 






Array 



Hcv-cs -the 

oY\t 'you 

need* 



You were asked to match the data structure names on the left with 
their descriptions on the right. You were also to identify which one you 
thought you might need to use for the surfer data. 

A variable that allows data to enter 
at one end of a collection and leave 
at the other end, supporting a first-in, 
first-out mechanism 

A variable that contains data arranged 
as a matrix of multiple dimensions 
(but typically, only two) 

A variable that has exactly two 
columns and (potentially) many rows 
of data 



A variable with multiple indexed slots 
for holding data 

A variable that creates a chain of data 
where one data item points to another 
data item, which itself points to 
another data item, and another, and 
so on and so forth 

A variable that contains a collection 
of unique data items 




MuhTclimeiisfoncil array 



Use a hash 



_ m tV* P^ 0 
as a w d'»fc-t'»ov\av'/- 



, u/ovld 



You need to use a data structure that maintains the 
association between the surfer score and the surfer name, 
which is exactly what a hash gives you. There are lots of 
surfers with lots of scores, and you need to maintain the 
association between the two pieces of information. 

Let's take a look at how hashes work. 




Gee| Bits 



Hashes go by different names in 
different programming languages: 
mapping , dictionary , associative array and 
key-value list , to name a few. In this book, 
we’ll stick to using the name hash. 
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Associate a key with a value using a hash 



Start with an empty hash: 






{ } 




You add data to an existing hash by describing the association between the key 
and the value. Here’s how to associate a surfers’ name with their score: 
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iterate hash data 



Iterate hash data with for 

Let’s add some additional rows of data to your hash: 



scores 



scores [9.12] 
scores [7.21] 



Once you have a hash crea , } 

for loop to iterate over each of the rows: 




pa-ta i* a hash is 
mainlined m 3 

seemingly random order, 
but don't worry about 
that tor nOW- 



The "keys 0” built-in method returns an array ot 
the keys of the hash. There are no e*tra fomts +or 
^essinoj what the "valuesO” method does. 



Jake each of the 
ktf y* the hash 

turn... ^ v- 

for key in scores . keys ( ) : 

print (scores [key] + 1 had a score of 1 + str (name_part ) ) 

...and display a Custom ^ 

message using the dab IVhen referring to a value associated with a kev us, 

• m each row of the hash. square brackets (just like you did with array K 



Python Shsll 



Hev'Vs what would 
display on screen - — 
(assuming all -bV^c 
data in Vsults.t*t’ 
was available to tbe 
basb). 



£iIp £fiit F.hpJI Hphnn^ Winrinwi 



Joseph had a score of fi .43 
Juan had a score of 9 . L2 
•Zul-Il held d. “■■■_; or. t u£ 7.31 
Aaron had a score of 
A. J I lh!E-! n llrilt ,t M I It I r h? C I r n.n'h 
Johnny fowl a □core of Buth 
Sfc.H.L:i-;y '.ri:l ri Mi:ci!r+f iiT 7.R1 

»> | 



JJpIp 



I n: nm 4 1 



Another hash method, called items ( ) , returns each key -value pair in turn, 
and can be used with the for loop, too: u . 

f he iy-sO" method returns each 

key-value paiv. 

for score, surfer in scores . items ( ) : 

print (surfer + ' had a score of ' + str (score)) 



Whichever method you use to iterate over your hash’s data is up to you, 
because using items ( ) or keys ( ) produces the same output. 

1 54 Chapter 5 
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Code Magnets 

Rearrange the code magnets at the bottom of the page to complete 
the program shown below. Rather than using two arrays, this 
program stores the results from the surfing contest in a hash: 



result_f = open ( "results . txt" ) 
for line in result_f : 

(name, score) = line. split () 



result_f . close ( ) 

print ("The top scores were:") 




| ror each_score 















| print ( ' Surfer ’ 


1 + scores [each_score] + 


1 scored ' + each_score) | 


1 srnroc — / i 1 








I OUUlCb — 1/1 
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surfers with their scores 




Code Magnets Solution 

You were to rearrange the code magnets at the bottom of the page 
to complete the program shown below. Rather than using two 
arrays, this program stores the results from the surfing contest in a 
hash: 



You to start "itl> a* V ' asV ' 1 
as opposed -to a« e">?ty arvay- 



result_f = open ( "results . txt " ) 
for line in result_f : 




(name, score) = line. split () 

■ " e l ^ — A-PT^v sp|ittm<\ out ‘the dfid ”thc sCovc, use 

scores [score ] - J ^ ^ «^ e « as key of the hash a *d 

, P value of U y\3«nr\e 3s ”the value- 

result_f . close ( ) *cne veiiwc ^ 

You'll fi»d out soon why the 'We" 

print ("The top scores were:") hot the “har»e" is used (i* +U;. 

Use a for — case) as the key of the hash 

to fvotess the | for each_score in scores . k eys () : ' 

tontevts of 7^ ^ 

V ' asW | print ( 1 Surfer ' + scores [each_score] + ' scored ' + each_score) | 

N 

Display each vow -Cvom the hash, 
describing “the association- 



there 1 are no 

Dumb Questions 




Can I append data to a hash just like I did with an array? 




Can I use anything as the key of a hash? 



Yes, and no. There’s no append ( ) method for hashes 
like the one included with every array. To add a new row of 
data to an existing hash, use code similar to that used in the 
solution, above. Hashes do have their own set of methods, but 
append () is not one of them. 



No, you can’t. The rules Python applies here can be complex 
(as they can be in other programming languages, too). The best 
advice we can give you is to stick with numbers and strings as 
keys. Trust us: this isn’t as restrictive as it first sounds and is, by 
far, the best/easiest strategy to follow. 
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Drove 



Take the code from the previous exercise and use it to create a new file in 
IDLE. Gall your program scores_hash . py. When you’re ready, press 
F5 to run your program. 



tc0r&G_h ac h . py - /h 0 m rry p.'Head F ErctPrag/c ha pt« r 5 /ccd &. ( g< ores_ha Eh. py 



Flip Trlrt format Run Option r Winriow^ 



scores - [] 

reAul i- r = u|Kfn( ■' j i.m . 1 %\,~ )« 
tor line .n result_i; 

(nnuir r nrnrr J — 1 l nr . rvpl t | j| 
scores [ score ] - name 
r«uilt_f .cloae^ |i 

print ( "The top score a ¥crc;" ) 

1: eacJi_acore in scores . fceys n : 

print ( 'Eurfcr p + scores [ cach_ocorc ] + ' ocorcd ’ + cnch_3corcJ 







.,tk tke Uf^A »- (tv 




= 

>» 

T 1 1 k Lj ip aimrr m wk r Pf i 
Curler Joseph scored a. 15 
Surfer Juan scored 5. 12 
Surfer ZacSc scored 7.21 
Surfer Aaron acored Q.Ji 
Surfer Aideen scored 9.05 
Surfer Johnny scored 3.E5 
Surfer Sl.riiiny nc:Birr:cJ 7„fil 
»> 



Great! Your program now uses a data structure that allows 
you to associate two related pieces of data together. 
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sort the surfers 



The data isn't sorted 

Your program now associates surfers and their scores, but 
it displays the data from the hash in some sort of random 
ordering. You need to somehow sort the data in the hash 
to find out who actually won the contest. 



Python hashes don’t have a sort!) method 




In Python, hashes are optimized for speedy insertions and even 
speedier look-ups (searches). As a consequence, the good folks that 
created Python were less interested in providing a method to sort a 
hash, so they didn’t bother. 




...but there is a function called sortedO 



/ U II f Ihd smular de Site and implement 

t Tr ° ( rV * 1 P^mming 

languages. People a« ditW- id so al 
the Programming languages they create. 



Obviously, there’s a need to sort a hash so, again, the good folks that 
created Python decided to provide a really smart built-in function 
that has the ability to sort any data structure, and they called their 
function sorted ( ) . Here’s how to use the sorted ( ) function 
with your hash: 



Use -the "sortedO" -function to sort the 
keys o+ the "scores" hash- 

for each_score in sorted ( scores . keys () , 



<r 



Remember: the keys in you r hash are 

-the stores, wbidb are numbers, so we ask 
"sortedO" to order them highest-to- 
lowest using "reverse — True • 



reverse 



True) : 



print (' Surfer ' + scores [each_score] + ' scored ' + each_score) 



That’s one small change to one line at the bottom of your program. 
So, let’s go ahead and make that change. Now that you are 
sorting the keys of the hash (which represent the surfer’s scores), it 
should be clear why the scores were used as the key when adding 
data into the hash: you need to sort the scores, not the surfer names, 
so the scores need to be on the left side of the hash (because that’s 
what the built-in sorted ( ) function works with). 




Make the change to your 
code to use sorted ( ) . 
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Tost DriVq 



With the one-line change applied, save your program and press F5 to run it again. 



tcor&g hash sort -ad. py ■ /homa/barryp/HaadFfirEtProg/chaptar&^c + 



Eile Edit farmat Bun Options Windows 



BCOTGB - \ ] 

reault_f — □pca( n re3ulta.tKt v ) 

line . : re3uLc_l: 

( nojn.c P score) - line. split 4 ) 
score 9 [ score ] = name 
rcoult_f . close j } 

Printline top scores v?eii! " ) 

riinh nrorft .inrhftrf ( HcifirM .kr'y.i f. ) t rrivetmr: — Trnrji: 

print ( 1 Surfer ‘ + scores \ each_score ] + ' scored + eacn_score 



£ 



The stores av*e associated 
with -bKc suv-Ws names and 
-they are * oy/ sorted, too! 



Python shall 



Die Edit SheJI I}ebug Options Windows 



===================== = 

»> 

Tli ^ m :i i r i-: m wurpri 

Surier Juan ecoreO y.U 
Surfer Johnny scored 0.-65 
Surfer Joseph scored 0.4,5 
Surfer Aaron a cored 0 . J 1 
Surfer Aideen scored 0„O3 
Surfer Stacey scored 3.-BI 
S ur fm 7,ri< :1 ni :n e hi 1 7.71 

>» I 




Fantastic ! You've identified the top 3 
surfers. Time to hit those waves, dude! 



Surf-A-Thon 




Thai »akes ii ihv-ee- 
m— a— 'row tor Juan! 

you are here ► 
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When data gets complex 



Hot on the heels of your success with the local surfing club, you’ve 

just been contacted by the Regional Surfing Association (RSA) and 

they want you to write a new program for them ! RSA’s offering a 

brand-new, state-of-the-art, epoxy resin surf board as payment... 

once the program’s working to their satisfaction, of course. ^ f\\\s is too §ood 3* 

You’ve been wanting to try out an epoxy board for ages. The 
trouble is, they’re sooooo expensive and you’re a poor surfer. The 
waves will have to wait (yet again). But, the thoughts of surfing an 
epoxy board... now that’s worth waiting for. 



So what does RSA's data look like? 

Currently, RSA’s data is stored in a text file using a proprietary 

data format. For each surfer, there’s six pieces of data recorded on ^ av*c 

each line in the file. 

Here’s what the data looks like: 




the s<% pieces ot data- 



101; Johnny 'wave-boy' Jones ; USA; 8 . 32 ; Fish; 2 1 
102 ; Juan Martino; Spain; 9.01; Gun; 36 
103; Joseph 'smitty' Smyth; USA; 8 . 85; Cruiser ; 18 
104 ; Stacey O'Neill; Ireland; 8.91; Malibu; 22 
105;Aideen 'board babe' Wu; Japan; 8 . 65; Fish; 24 
106;Zack 'bonnie-lad' MacFadden; Scotland; 7 . 82 ; Thruster ; 2 6 
107 ; Aaron Valentino; Italy; 8 . 98; Gun; 19 



Competition ID. 

Name . 

Country . 

Average score. 
Preferred board type. 
Age . 




data is stored i* 

7 e ' Wi ^ a semidolon 
separating each P ,ede of data. 



RSA has tried importing this data into their favorite spreadsheet 
program, but that didn’t really work for them. RSA wants a 
program that allows them to quickly find a surfers’ data based on 
their Competition ID, then display the surfers’ details like this: 



£ath data <te»> 

is nicety labeled 




101 

Johnny 
USA 
8.32 

Board type: Fish 
Age: 21 



'wave-boy' Jones 



4 



Each data item is displayed 
on its own line, which makes 
■t really easy to read funlike 
the packed data tile). 
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Here's one surfer's data from the file, assigned to a variable called line: 



line = "101; Johnny 'wave-boy' Jones ; USA; 8 . 32 ; Fish; 2 1 " 

Grab your pencil and write some code to process this line and display it on screen like this: 



ID: 

Name : 
Country : 
Average : 
Board type: 
Age : 



101 

Johnny 'wave-boy' Jones 

USA 

8.32 

Fish 

21 



Hints: If you pass a string parameter to the split ( ) method, the data is cut where the string parameter 
occurs, as opposed to the cut occurring at a space character (which is split ( ) 's default behavior). Also, 
consider using multiple-assignment on the left side of the assignment operator when assigning more than one 
name-value pairing to a hash. 
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data display 




harpen your pencil 
Solution 



Here's one surfer's data from the file, assigned to a variable called line: 



line = "101; Johnny 'wave-boy* Jones; USA; 8 . 32 ; Fish; 21 " 

You were to grab your pencil and write some code to process this line and display it on screen like this: 

101 



ID: 

Name: Johnny 'wave-boy' Jones 

Country: USA 

Average: 8.32 

Board type: Fish 

Age: 21 



Cut the I’ikc o-P data 
every time the splitO 
►»ethod sees a semicolon. 



Here’s ore possible soluW 




lire — "I Ol ;Johrry Cave— boy’ Jores;US/\;03Z;Pish;Zl” 



Create ar empty _ 
hash tailed "s”. 



->s = 0 



..y/. 



Use rwu Itiple— 
assignment to assign 
the split data *(rom / p\rint( U |D : 
"line” to V. 



(sTid'3, sCdou^tv-y 3, stWage'3, s£Wd'3, sTage'3) - line.splitOyO 

'J K 



* + sDid'3) 
printCWame : w + sCnanc!) 



Display six ^ieely 

-Pov-matted messages 



on s£\reen. 



prints U Countv*y : l> t sDeou^tv-y 3) 

pv-mtC'/Werage: w + sDaverage 3) 

pvmtC'Boavd type-* w + sDboav-d^) 
V^jpv-mtC'Age: ” + staged) 
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Tost DriVo 



As always, you need to enter this code into IDLE before you run it. Then, save your 
program and take it for a spin by pressing F5. 



□ 

Flip Trlit 



Licfct; 



d Itp I ay_d ata . py ■ ;h om a/b a my p/Head F I rst Prcg/c h apters/c ad a/dtspla y_d at a . py 



fnrmflt Run Op Mon 1 ! Windows 



“ 1 01 ;Juh nay " wave-buy ' Jujl*?h-;USJL; 0 . 3-2 ; Tiali; 2,1“ 




jjplp 



a = {> 

{ a- [ 1 id ' ] s[ ' iidjac ' ] , a [ 1 CHUU]] L l y 1 ] , a[ 'dvcLdye 1 ], b[ 'budi d " ] T b[ ' aye 1 ] ) = line. apllL ( “ ; “ ) 



[jniiiL ( "ID 1 : 
print ( "Nome : 
print ( "CuuiiLiy : 
print ( "Average: 

In L ( “ Bu d id L y £ie : 
print ( " Age : 



" + =■[ ' ld ‘ U 

m + o ■[ ' nOBC 1 ] ) 

“ -+■ » [ 1 L-uurLiLLy ‘ | j[ 

" + 3 [ 1 average 1 | J 

" + a [ ’ LH-.iBi.iJ 1 ] J 

M + al'agc' ]1 



I 



Python shall 



Hev, tW.s data is ^ 
pretty easy to vead, 

*? 



Eile Edit EihieJI Debug Options Windows 



F 

Eil 

I Python J . 1 . L [rilliMJHU, Aug 1 H <J 7 iU 3 H 5 | 

[nc.r. 4.: 1.1] L-m lirnix? 

Type “eopyriqnt" r "criditB" or "XicenBsf)" tor mere i nl ormat ion . 
»> RESTART 



ID: 

Name : 
Country : 

IW e l By e : 
Board type: 

ftHJhSI 

»> f 



101 

Johnny 
U&A 
B. J2 
Fiob 
21 



1 wave-boy " Jones 




Your code works for one line of data. But RSA wants to be able to 
display the data for any surfer, not just wave-boy's. 
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function to hash 



Return a data structure from a function 

Processing one line of surfer data was pretty straightforward. But now you have 
to work with all the lines of data in the file. Your program has to make the data 
available quickly so that a request to display the details of a particular surfer can 
be performed as soon as possible. 

You already know enough to write a function that takes the surfer ID as a 
parameter, searches the file one line at a time for a matching ID, and then returns 
the found data to the caller: 



ihe su^ /£> 




There are really only two choices for how you return data from this function. Pass 



back the surfer’s data either: 


o 


As a string 


or 




o 


As a hash 



But which? Returning a string requires the calling code to further process the data to 
extract the information it needs, which (although possible) gets messy, because the calling 
code is then required to cut up the string using split ( ) . This is something best left to 
the function, because it hides the complexity of manipulating the data from the calling code. 
Returning a hash allows the calling code to simply pick out the information it needs 
without too much fuss and without any further processing. 

Return a hash from the function to keep the calling code simple. 
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Code Magnets 

Rearrange the code magnets to complete the function required. The following 
functionality is implemented: 

1 . Accept a single parameter (the surfer ID). 

2. Process the data file one line at a time, creating a hash from the line on each iteration. 

3. Compare the parameter against the ID read from the file. 

4. If the IDs match, return the hash to the caller. 

5. If no match is found, return an empty hash to the caller. 



def find_details (id2find) : 



for each_line in surfers_f : 



surf ers_f .close ( ) 



surf ers_f .close ( ) 




return (s) 



j-d2find == int (s [ ' id ' ] ) ; | 
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process the parameter 




Code Magnets Solution 

You were to rearrange the code magnets to complete the function required. The following 
functionality is implemented: 

1 . Accept a single parameter (the surfer ID). 

2. Process the data file one line at a time, creating a hash from the line on each iteration. 

3. Compare the parameter against the ID read from the file. 

4. If the IDs match, return the hash to the caller. 

5. If no match is found, return an empty hash to the caller. 



def find_details (id2find) : 



0 ? en the tile so that you 
ta« read the data- 



to 

,00 P through 
m the -fi| e . 




surf ers_f = oP en( 

for each_line in surfers_f: 

, /Hake sure the hash starts out empty- 



s = {} 






Chedk i-p -the IP ^ ' 

supplied as a p aVameteV 

is the same as the one 
v-ead -Plrom the -Pile. 



(s [ 1 id ’ ] , s [ ’ name ’ ] , s [' country ’] , s [’ average ’] , s[ ’board’], 
s [ ' age ' ] ) = each_line . split ( " ; " ) 



if id2find == int (s [ ' id ’ ] ) : 



surf ers_f . close ( ) 

^5=. V^ou have a matdhl So, dose 
the -Pile then vetuv-n the 
duvvent hash to the dallev- 



Cut up the line fusing splitO) and 
assign the data to the hash (using 
multiple-assignment). 



return ( s ) 

surf ers_f . close ( ) 




r p*®** the entire 

t, b f HO MATCH. 

Close the -file and return an 
ern pty hash. 



f 

this! 



Download surf ing_data . csv from 
the Head First Programming website before 
continuing. Be sure to put the file in the 
same directory/folder as your code. 
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S Reapy Ba^e 




Here's some tester code that we've cooked up especially 
for you. This code will let you test your function: 

Ask -the user -for ihe 

sur-fer IP to f ind- ~V> lookup_id = int ( input ( "Enter the id of the surfer: 

uf% . . surfer = f ind_details ( lookup_id) 

Call tind_detailsO 

on the entered su rter IP if surfer: 



l-f data was tound, 
display the nitely 

formatted messages 



print ("ID: 
print ( "Name : 
print ("Country: 
print ( "Average : 
print ( "Board type : 
print ( "Age : 



+ surfer [ ’ id’ ] ) 

+ surfer [ ' name 1 ] ) 

+ surfer [ 'country' ] ) 
+ surfer [ 'average' ] ) 
+ surfer [ 'board' ] ) 

+ surfer [ ' age ' ] ) 




Tqst DRIV 0 




Type this tester code, 
together with your 
function, into IDLE. Be 
sure to put the function 
near the top of you file, 
so that this tester code 
appears after it. 



Make sure the tester code and your function are entered into IDLE and saved 
to a file as a new program. Press F5 to test your function. 



c 

Tile Tfiit r .hp|l Dphiir] Gplmn^ Winrinw 1 ! 



Python shell 



Enter an existing swvtev 
IP and the program 
displays the details. 



Enter a nonexistent 

sur-Per / P and the 
p^ogv-dr* displays 
nothing there's — 
nothing to display). 



rython a. 1,1 (rill: fllVV, Aug Its 2UUU, 
[CuC-C 4 _ Ti - .1 1 eprt linux? 

Type ■ copyright " F "credits" 

»> =================== 

>» 

Tlritrv thr id nf the- surfftri 



Iicene©()" tor nvore m forma t ion . 
==== Rn.STftET =================== 



ID* 

HjriTnr : 

Cotint ry t 
Average ; 
Board type: 
Age: 



104 

Rt.nr.ny Q'Urin 

Ireland 

B.S1 

Kalitrn 

22 



»> — 

Enter 

| 



RESTART 



the id of the surfers 202 




Great work! Your function is working well. Wonder how the RSA 
folks feel about it? 
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surfing success 



Here's your new board! 

The RSA folks are delighted with your work. 




Your program really hits the mark. The RSA folks can display 
the data from their tightly packed data file in a way that makes 
it easy for them to read and work with. It’s fast, too. 

Your use of a hash within the function was an inspired choice. 
The calling code only needs to be aware that a hash is being 
returned from the function to work with it effectively. And, as 
you’ve seen, returning a data structure (like a hash) is as easy 
as returning any other variable from a function. 



s your brand 
boav-dh. start 



new 



it> dude! 



Word of your programming skills is spreading 
far and wide. 

1 68 Chapter 5 
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Meanwhile, down at the studio... 



You come highly 
recommended from 
RSA. We have a very 
similar requirement at 
TVN... would you consider 
selling your code to us? 



Head First TVN is an up-and-coming sports 
network specializing in everything and anything 
to do with water. They are covering the National 
Surfing Championship and want their TV 
presenters to be able to use your program to 
access each surfer’s details in much the same 
way that RSA did. There’s just one small kink in 
their plans: TVN has all their data in a database 
system, not in a file. 

^ The TVN CBO 










Which part of your program is most likely to change if you have to get the 
surfer data from a database, as opposed to a file? 
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The code remains the same; it's 
the function that changes 

Your program expects the find_de tails ( ) function 
to return a hash representing the surfer’s details. Rather 
than the function searching the file for the data, it needs 
to search the TVN database, convert what the database 
provides to a hash, and then return the hash to the 
calling code. 

All you need to know is which database system TVN 
is using and how to access it from your function. 

Let’s base your code on TVN’s code. 





Reaps* Bane 

Here's the TVN code 



Import -the standard ->jT 

, „ . . ^import sqlite3 

S§LiW library 
and tonnett to the 
data in the database 
-file (whith you tan 
download 'f'rono this 
book*s website)- 

Protess eath ot 
the rows... 

...looking tor a 
swrter wto has an 

IP ot \ 0 \. 
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Rewrite your function to retrieve the data it needs from the TVN 
database. Use the ready bake code as provided by TVN's technical 
people as a basis for your code. Bear in mind that your program 
expects the data in the hash returned from the 
f ind_details ( ) function to be a collection of strings. 
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grab the data 



Jharpen your pencil 
^ Solution 



You were to rewrite your function to retrieve the data it needs 
from the TVN database. You were to use the ready bake code as 
provided by TVN's technical people. You were to bear in mind 
that your program expects the data in the hash returned from the 
f ind_details ( ) function to be a collection of strings. 



iwppyt. 



.... de.f . 

./.. d.b. .= . ereDB.-;s.db'.7 

^yab all -the suv-fev- j 

data from the .... ... db:V.pw i jtafitfi'rY .=•. s‘\lite2-.R<w 

database, as opposed—-^- c „ /, 

to the -file- -V- MMnttd). 

........ .*. .f r.<?». suyfeys''.). 

. . . .X^yffy/s. =: .tvyspy.-fe&.ballQ 

f<?y. ypy/ ,i*j. rpws; 



iVhen a matth is -found— — ^ if .yp.'f/.Ci.d.' J. • t~ . idifwd; . 



,.S .=...{} 

sC'id'J ^.sty(yp.y/.rid']). 



...build the hash one /..... sCnan'.d rr. .yp'w.r'n.an'e^ 

key-value pair at a 

time- ^ . . . v ^. . . . sCtpu.ntyy , .3. =; r.pwffipunty.y’J. 

.... sCave.ya.ge'J ,^y(y.pwf aveya^id? 

.... sC.‘b.payd!3. ...=•. .yswCbpayd! 3 

sC'd$e'J — .styfyou/t'a^e’J) 

Return the hash 

to the callinq _ _ i / ■> 

tod. (a befcj=^=»- 

du\rso\rdloscO 
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Tqst DriVs 



Change your program in IDLE to use the new version of the function (which now talks 
to TVN’s database). Save your program under a new name and press F5 to run it. 



tq nd It . py - yh sm « <b arry p/H oadFl rat P rog/eh a p + 



Flip r_riit fnrmflt Rim Option 1 ! Windows 



r Lsaa this! 

4- 



jjpjp 



impor-. oqlitcJ 

-:lc t 1, i nd_dcto iio [ 1 HZ £ ind ) : 

c]li = aijl i I.p; 1 .i:nnnffc:L. ( M -■ i ■ Fh-r mIIPI . mSEi s ) 
dO . row_£actory - □qiitci.now 

■aii r he ht = rHi 4. iiLirnnr ( ) 

cursor . execute ("ac Ice t * £ rom ou z £ c r □ n i 
■ iiu» = [:ur»[jr . r^l.clml] ( | 

1 : row in rows : I 

Flip Friit r «hpJI Dehijp Hpfrhnn^ Window 1 ! 



Download surf ersDB . sdb from the 
Head First Programming website before 
running this test drive. 



B - U 
*[ ‘ ] 
s[ 1 name’ J 
.-i [ 1 r.cv\ i nt r 
b \ 1 averaq 
.-i [ 1 hon rd 1 

*['* qe‘ 3 

rumnr + di 
return | s ) 
c;uriif>r i n'lntif:( J 
return^ (1 3 

looltup_i(l - int( input 

surfer - £ind_detailB 

if lenjsurrer] * 0 -. 
print ( "ID : 
print ( “Narae:: 
print ( "Country 3 
print £ "Average: 
print ( " Do nrd t ype 
print ( "Aqe: 



Python shell 



jjplp 



i'ytnon J. 1 .I ( rills / 44 iK?, Aug IH 2 UG 9 , U/:Ui: 40 J 
[GCC i. 3. 3 I U 1 L 1 in Li a: 2 

Type “copyright" P " credit □" or "iiccnuc[ ) " tor core inlormation. 
>» =============================== RESTART =================== 

>» 



"Rnl me 1 Ian id uF t.hr ulltTkt : 
ia i 

E1j-i him i .Tlli-lh HnrE. inn 

Country; Spam 

dHjn;^ 9.01 

Hoard type : Cun 

flHj^X Ifi 

»> 



103 



Hnter tne id o£ the sutler: 2ya 

»> U , . - 



l 



Tlntrr thr: id raf thr-; rrnrfrr: 1 Oft 

XU 1 iUb 

Mrimr : ?, n rrlr 1 hrm n i r:— 1 n. d p Mas: T n dd r-sra 

Country: Scotland 

Avrrngft : 7 . 02 

Board type: Thruster 
Age; 2G 

| 



I n ? r > Tnl 4 1 



Now, as well as working with data in files, you can extract data from a database 
system. Your program fully integrates with TVN’s SQLite3 technology. 

Send off that code to TVN, and sit back and wait for the 
money to roll in... 
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data in the spotlight 



TVN's data is on the money! 



With the surfing data now displayed directly from the TVN 
database, the sports writers no longer need to worry about all 
those tattered and torn competition entry forms. The data 
is right there on screen when they need it. They couldn’t be 
happier. Your program has made their day. 





The TVN spov-fcs 

k*ow how io 

telcloraie. 
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Your Programming Toolbox 

You've got Chapter 5 under your belt. 
Let's look back at what you've learned 
in this chapter: 



, a data 

as sot»a v , 

“ , date ***** 



taWcd 



Jfyo**' a 
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* Keeping things straight 



w 




The code that you write will make its way into many programs. 

And, although sharing is good, you need to be careful. One programmer might take your 
code and use it in an unexpected way, while another might change it without even letting 
you know. You might want to use one function in all your programs and, over time, that 
function’s code might change to suit your needs. Smart programmers take advantage of 
modular programming techniques to keep their workload manageable. Let’s find out how 
in the pages that follow... 
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technology upgrade 



Head First Health Club is upgrading 
some systems 



Head First Health Club has a new GEO, and he loves new 
technology. He was shocked when he saw how old the sales 
systems were. 




Old a*d 



|slew 



Some of our technology 
is really ancient. I want to 
start by replacing the cash 
registers with new POS 
systems. Can you help? 



The old £ash registers 
really heed to be replaced. 

A/ 



The new s</st ern will VW" 
on a PC and atteft 
tved \i tavd ?ay™enb 







A point-of-sale (POS) system is just a computer program that 
works like a cash register. The boss doesn’t want to replace all 
of the cash registers immediately. He wants to begin with a trial 
system in the coffee bar. 

Let's see what the coffee bar POS needs to do. 



It would be hide i-P the systems 
you produce were modular in 
design. You'll get to that 
AF TBR you've speht some time 
understanding what's required. 
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The program needs to create a 
transaction file. 

The POS program will record credit card sales in a file called 
transactions . txt. At the end of each day, this file is sent 
to the bank and any money is transferred from the credit card 
account into the health club’s bank account. 

The bank has sent an example version of the file for you to see 
what sort of data you will need to generate: 



The -first I& characters are ^* e characters descriptions follow- 

the Credit card number- ^ a<re P* ri6e ^ 




The file contains formatted data. There’s a line of text (or 
record) for each item sold. The first 1 6 characters of the line 
are the credit card number, followed by 7 characters that 
represent the sale price, excluding the decimal point (so SI. 7 5 
is written as 0000175 ). The rest of the record is a description 
of the item being sold. 







How would you create a string of characters in the correct format for the 
record? Which parts of the record will be the hardest to create? 
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string formats 



Use strings to format strings 



Many programs need to create strings with particular pieces of data 
at particular places, so most computer languages try to make life 
easier for you by letting you use string formats. 

The best way to understand string formats is with an example. Open 

up the Python Shell and type in this: 7 ^ va | uc wj || 

be inserted as a 
■ ^-dbarad-fcer number. 

»> print ("There are %5d %s available" % (17, 



The sefcond value Will he 
y inserted as a sbrmiy 

’donuts" ) ) 



There are 



7. 



17 donuts available 



Tbe number has extra spades 
added at tbe -front; to make 
sure it takes up tbe required 5 
dharadters. 

When Python sees a string followed by a percentage (%) symbol, 
it knows that it needs to consider the string as a string format. 
The values that follow the % operator are going to be inserted into 
the formatted string in the order specified, one value at a time. 
Wherever Python finds a % inside the string, it knows to insert a 
value. 

A number -format Is — 

speei-fieatioK ->> %5d 



When Python sees this, it will insert the value 1 7 as a 5-character 
whole number — that’s because the “d” type specifier tells Python 
to print the number as a decimal. Because 1 7 is not 5-characters 
long, Python will left-pad it with 3 extra spaces at the front to make 
it the correct length. 



A string -format^- g 

spedi-fidaW 

This symbol tells Python to insert the value “donuts” as a string. 
As you are not specifying a length here, the string is inserted as is. 



The 

perator 







These are just two examples of how to format 
values in a string. There are lots more. 
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% •: + 

+ THAT'S 

• + 

Match each format string to what it does. We’ve already done one for you. 



"%s %e" % ("Value is", 16.0 ** 0.5) 




"%s is $%4.2f" % ( "Popsicle" , 1.754) 

"%s %f" % ("Value is", 16.0 ** 0.5) 
"%07d" % (11232/3) 



Display a string followed by 4.000000. 



Display a string followed by 4.000000e+00. 



Display the value, padded with 0s. 

Display the result of the calculation, padded 
with spaces. 

Pad the string out to 20 characters, then display a 
newline character. 



Display the number as a hexidecimal (base 16). 

As well as a string, also display a floating point 
number to 2 decimal places. 




Be tar * Pul wi-fch -the 
de£ir*al poiirt ih -the 



Look back at the records you need to create for the transaction 
file. Each line will need to end with a newline character. If you 
have the credit card number, price, and description in variables 
called credit_card, price, and description, write 
down what you would use for the format string: 
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format string 






+ 



l( you have just 
one value -to -format 
you don'- 1 need to 
surround it with 
parentheses. 



You were to match each format string to what it does. 



"%s %e" % ("Value is", 16.0 ** 0.5) 



"%7d" % (11232/3) 



"%x" % 127 

H \n means take a HBWLIHB. 

"%20s\n" % 

This means "use ^ dbaradiers. 

”%s is $%4 . 2f" 

\ 

This means 
a-fter the 
"%s %f" % ( 



"%07d" % (11232/3) 

r 

Following the % with a O 
means 'pad with zeroes” 




Display a string followed by 4.000000. 



Display a string followed by 4.000000e+00. 



Display the value, padded with 0s. 



Display the result of the calculation, padded 

with spaces. ^ By default P7-tV.cn Will ?ad 

usin^ spades. 

Pad the string out to 20 characters, then display a 
newline character. 



Display the number as a hexidecimal (base 16). 






As well as a string, also display a floating point 
number to 2 decimal places. flexadedimal numbers 

are used tor things 
like dolors on tbe Web- 



Jharpen your pencil 
Solution 



You were to look back at the records you need to create for the 
transaction file and write down what you would use for the 
format string: 

Multiply^ by \00 and 
displaying it as a whole number 
e-ftedtively removes the 
dedimal point £rom the pride- 



Pon't worry i-f your answer doesn't 
look EXACTLY like this. Try out your 
answer in the Python Shell to dhedk 
that it works. N \^ 

u %l&s%07d%l^>s\n” % (dredit__dard, pride^lOO, description) 

:>■ ^ 

Credit dard numbers should always you need a newline dharadter 

be e*adtly l^> dharadters. at the end ot eadh line. 
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Code Magnets 

Now that you know how to format the records in the 
transactions . txt file, it is time to write the rest of the coffee 
bar POS program. Complete the code below by arranging the code 
magnets in the correct place: 



def save_transaction (price, credit_card, description): 

file = open ( "transactions . txt " , "a") ^ 

file .write ( M %s%07d%s\n" % (credit_card, price * 100, description)) 
file . close ( ) 



The "a" means you are always 
0,01*3 APPEND vetoes 
-to -the end of the tile- 



t 



This is the -format string you just treated- 



items = ["DONUT", "LATTE", "FILTER", "MUFFIN"] 
prices = [1.50, 2.0, 1.80, 1.20] 



running = True 

while running: ^ — 

option - 1 

for choice in items: 



The loop will keep while 

the 'Vurmin^ va viable has the 
value True- To end the loop, set 
w vurmm$ to False- 



option = option + 1 
print (str (option) + ". Quit") 



if choice == option: 



else : 
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Code Magnets Solution 

Now that we know how to format the records in the 
transactions . txt file, it is time to write the rest of the coffee 
bar POS program. You were to complete the code below by arranging 
the code magnets: 



def save_transaction (price, credit_card, description): 
file = open ( "transactions . txt " , "a") 

file .write ( "%s%07d%s\n" % ( credit_card, price * 100, description)) 
file . close ( ) 

£^-TWis is -iv>e avvay <£ mew °?tio«s. 

items = ["DONUT", "LATTE", "FILTER", "MUFFIN"] ^ 

prices = [1.50, 2.0, 1.80, 1.20] ^ This is the dv-v-dy o-p menu prices. 

running = True 



while running: 
option = 1 



tT" "^*' s do< k displays -th e 

ptrogv-ar* s 




sOption = option 
print ( str (option) + ". Quit") 

I ^-The user eAevs a mew 

int (input ( "Choose an option : " ) ) L option wmber to * 



if choice == option: 



■This will be True i-f -the user selects the L AST 
running = False I 0 U l0ln oh 'tbe menu, whidh is "djuit ” 



else : 



credit_card = input ("Credit card number: ") 



save_transaction (prices [choice - 1], credit_card, | items [choice 
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Drove 



The machine has been set up in the coffee bar just in time for the 
boss to come in for his morning latte, so let’s run the code and see 
what he thinks. Run the program in IDLE: 



Shvl! 



£dif nhiMI Qtfiijr; Of 1 1 1 r. r» «. ^indHNCi 

fr'i'bhGJi J.0.1 I r JG1 i i y j'fj , Tub 17 L 3 3 E 3 = 3-V ] 

ryp« - ccg»^?-iqhi 1 “ r ~i=r«s|-t" - qt L4vfr» [ | " T3r “ 

— <■ BliTART 

>» 

: . kheut 

J . 

i , r FI-TU 
4 . huttiH 

Ouii 

irhcwTinA n n r- j i + Liw : J 

Credit card, nmfea ri fi 3* 2 74S-2 S&7£4 H 32 
l . dce-iut 

j. latte; 

3 ■ FILTEJ1 
j. Hurini 
T> . Quit 

L'KcHinn run isjhl.Lim: 1 

Ccedlt c&ril bUHfeAlN bl«TU2ll/^B» 

| | , D02JQT 
. LB.TTIC 
| 1. FlLCO 
J i K1FFFTJI 
| 3vr Qull. 

Cheoae aji GjM.i-na: 3 

i »:■ 



The sales are recorded in 
the -fcransa^fcions.-fcx-fc -file. 




The program displays a list of items for sale and when you choose 
one and provide a credit card number, it adds the sale into a file 
called transactions . txt. This is the same file that the POS 



The newline tharafcter, 
makes sure the sales are 
recorded on separate lines. 
(You ean t see then in the 
-file, but they are there ) 



system in the gym uses. 




The boss agrees to try out the system in the coffee bar, and he even 
agrees to extend the trial and let your friend create another POS 
for the gym, based on your code. 




Things are going really well. If they continue like 
this, you will win the contract to replace all of the 
systems at the health club! 
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real-world format strings 




Ike Format Stmg Exposed 

This week’s interview: 

Why do appearances matter? 



Head First: Format String, it’s a pleasure to meet 
you. 

Format String: The pleasure is all mine. 

Head First: You’re not just used in Python, are 
you? 

Format String: Oh no. I’m really used in lots of 
programming languages, like G, G#, and Java. You 
see me crop up all over the place. 

Head First: Why is that? 

Format String: Well, I don’t like to blow my own 
bugle, but I am kind of useful. Everywhere you need 
to generate formatted text, I can make life a lot easier 
for you. 

Head First: Gan you give us some examples? 

Format String: Oh sure. If you need to send data 
to another system, you’ll probably need me. If you 
want to display an error message in a specific format, 
I’m good at that, too. 

Head First: I hate to say this, it seems so rude, but 
isn’t it possible to do everything you do with just 
normal string operations? 

Format String: Please, I don’t take offence. Yes, 
you can do pretty much everything I do by writing 



code and creating strings manually. But I don’t think 
that’s a great idea. 

Head First: Why’s that? 

Format String: Two reasons: first, you might have 
to create a lot of code, and second, I’m a little more 
dynamic. 

Head First: What do you mean? 

Format String: Well, I’m just data. Lots of times, 
programmers prefer to use data instead of chunks 
of code, because it means they can store me away 
as configuration. So I get used a lot for things like 
internationalization. 

Head First: Internationalization? 

Format String: Yeah, say someone wants to display 
a message that someone has the top score. They 
could write the message in a file like “%d is the top 
score!”. If they write a French version of the game, 
they just have to amend me to “%d est les points 
superieurs!” 

Head First: No code change necessary. 

Format String: Exactly. 

Head First: String Format, thanks for your time. 



tliereicffe no 

Dumb Questions 



% Those format strings look a little 
weird. How do I find out more about 
them? 



A good reference book (we present 
our favorite in the appendix) will contain all 
you need to know and there's also lots of 
material on-line in the official Python docs. 
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O: Are there special rules for what's 
acceptable as a credit card number? 



n: Why does the code generate the 
menu in such a complex way? 



Yes, there are. But let's not get 
bogged down in those type of details at this 
stage. Concentrate on the 
save_transact ion ( ) function 
and how the code interacts with it. 



If you study the menu generation 
code, you will see that when you add more 
items and prices, the rest of the code 
doesn't need to change to support the new 
items.The menu is generated automatically. 
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A late night email ruins your day 

A few days after the demo, you get a late night email from the 
friend who wrote the second program (based on your code): 




Something really strange has happened. Even though your code used 
to work, it has suddenly started to go wrong. Meanwhile, your friend’s 
program, which is really just a modified copy of your program, is 
working perfectly. 

Looks like you better get to the health club bright and 
early tomorrow morning and see what's happened. 
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pricey donut 



*50,000... for a donut?! 

When you arrive at the health club you find out exactly what’s 
happened. The entire day’s sales have been rejected by the 
bank for two reasons: 




© 



The credit card numbers are all fake/invalid. 

The bank was really worried about this one because they think someone 
must have hacked into the system to generate the messed-up credit card 
numbers. 



© 



The prices are ridiculous. 

One of the recorded sales was for a donut that cost over $ 50 , 000 ! 



And what makes it worse, this 
was the first time we sent the 
transaction file to our new bank! We 
only switched over the day before 
yesterday so that I could secure a 
loan for the new weight room! 



This looks like a really serious 
problem. Let's take a look at 
the file that the bank rejected. 




188 



Download at WoweBook.Com 



modular programming 



Only the sales from your program 
were rejected 

The transactions . txt file that was sent to the bank contains all 
of the day’s sales from both your POS program in the coffee bar and 
your friend’s POS program in the gym. This is a section of the file: 





is -from -the 
bar and was 

RBJBCTBV by -the bank. 



50791428746281510000150 

00035005002454912715921 



DONUT 



WORKOUT 



r 



TW»s 



ar>d 






As expected, each record (from each of the POS programs) has been 
appended to the transactions file. That bit appears to be working fine. 



V>arV-* 



But, something is not quite right here... 



Study the two records carefully. Is there a difference between them that 
might explain why one was accepted and the other was rejected? Think 
about recent events. What do you think has caused this problem? 
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change in format 



The new bank uses a new format 

Your friend tells you that just after taking a copy of your code, the word 
came down that the health club was switching banks. Without telling you, 
your friend found out the new bank format and updated his code in the gym 
program. 

That means that the POS program in the gym is generating records in the 
new bank format. 

The new bank format is: 



Price / Credit Card / Description 



This is the price: f&.oo. 



This is the tv-edit 
tav-d number 



.The Ub\ part is a 
\£ d esdY^t»oK ok the sale- 



0003500 



5002454912715921 



WORKOUT 



OK, that's another 
workout sold, so I'll write 
Price.... then Credit Card... 
then Description... 



O 



O 



The bank accepted the transactions from the gym because 
they were in the correct format. 



But what about the coffee bar program? 
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Your coffee bar program still uses 
the old format 



Your program in the coffee bar was never updated after the health club 
switched banks. It’s still doing what it always did: it’s still creating files 

in the old format. 

That old format wrote out the price and the credit card the other way 
round , which meant when your program wrote out a record like this: 



So that's a donut. 
Better write Credit 
Card... then Price... 
then Description. 



The Credit card rubber 



Price - fl SO 



5079142874628151 



0000150 



The new bank read the record like this: 



The pride... feoJIl.^Zl 






5079142 



DONUT 



pesCripW 



Messed »? <*edit card m^r- 
the bark thought «t *as bake- 

A/ 



8746281510000150 




^ But at least the 
description s 0\C. 



DONUT 



This is suspicious... 

$50,000 for a donut.. 

Does not compute... Fake < ^ 0 
credit card information! 

Security! Security!! 



So it’s not that somebody broke into your program and changed it. 
No, it’s the exact opposite. Your code never picked up the change that 
was made to the gym program in order to support the new format. 




J 







What should you do to fix it? What shouldn’t you do? 



you are here ► 



191 



Download at WoweBook.Com 



don't copy , share 



Pon't just update your copy 

The code in the gym program is a copy of your code in the coffee bar. 
And copying code is a bad thing. Once you have two separate copies 
of a piece of code, then changes need to be applied in two places. 
So how do we avoid copying code? 

Smart programmers write modular code 

The secret is to break your programs into smaller pieces of code 
called modules. What’s a module? It’s just a file containing code the 
computer can run. Every Python program you’ve written so far has 
been a single module. 

But most programs you’ll write will probably be split across many, 
many modules. And writing modular code is important because 
modules can be shared between programs. 





is a 



SttAREP module- 



transactions, py 



If you separate out the code that saves the transactions to a file and 
store it in a new module called transactions . py, that module 
can be shared by both programs. If you then ever need to change 
the code in transactions . py, both programs will pick up the 
changes automatically. 
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So how do you create a module...? 

Remember: a module is just a file containing some Python code. So, take the 
code that you want to share out of the gym_pos . py file: 




Then save this code in a file called transactions . py. You have just 
created a new module. 



...and how do you use it? 

Once you’ve created the module, you then need to tell the programs to use it. 
When you were using library code you needed to import it. You do the same 
thing with your own modules. So, instead of using library code from the 
Standard Python Library, you’re really just using library code that you’ve 
written yourself. You can add this line to the top of each of your programs: 



Jhis line h ee( J s ^ b e ^ded 

y a *y P^a* Ihai uses the_^ 
transac-Bohs-py" module. 



This rr,ea*s toA 

the narxed module- 

* 

from transactions import 



* £=~This means “treat everything inside 

-the module as i*P ft is £ode within 

» 

your program. 



With this line, you are telling Python that you want to run the code in the 
transactions . py file and this allows you to access whatever code the 
module contains as if it is just part of your program. 

It's time to fix the programs. 
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tale of two programs 




This is the code to the 
''toWee_.p0s.p7' proy-a**- 



These are the two POS programs. Here is the code to the one 
used in the coffee bar (that you wrote): 



def save transaction (price, credit_card, description): 

file = open ( "transactions . txt " , "a”) 

file . write ( "%16s%07d%16s\n" % (credit_card, price * 100, description)) 
file . close ( ) 

items = ["DONUT", "LATTE", "FILTER", "MUFFIN"] 
prices = [1.50, 2.20, 1.80, 1.20] 
running = True 

while running: 
option = 1 

for choice in items : 

print ( str (opt ion) + ". " + choice) 

option = option + 1 
print ( str (opt ion) + ". Quit") 
choice = int ( input ( "Choose an option: ")) 
if choice == option: 
running = False 
else : 

credit_card = input ( "Credit card number: ") 

save_transact ion (prices [ choice - 1], credit_card, items [choice - 1] ) 
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The other program is very similar (which your friend created for use in the gym): J^is - |S ^ ^ 

"ay^-pos py" program. 

def save_transaction (price, credit_card, description): 
file = open ( "transactions . txt n , "a”) 

file .write ( "%07d%16s%16s\n" % (price * 100, credit_card, description)) 
file . close ( ) 

items = ["WORKOUT”, "WEIGHTS", "BIKES"] 
prices = [35.0, 10.0, 8.0] 
running = True 

while running: 
option = 1 

for choice in items : 

print ( str (opt ion) + " . " + choice) 
option = option + 1 
print (str (option) + ". Quit") 
choice = int ( input ( "Choose an option: ")) 
if choice == option: 
running = False 
else : 

credit_card = input ( "Credit card number: ") 

save_transact ion (prices [ choice - 1], credit_card, items [choice - 1]) 

Using a pencil, modify the two programs so that they use the transactions . py 
module. Then write what you think should go into the transactions . py module here: 
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transactions module 




These are the two POS programs. Here is the code to the one 
used in the coffee bar (that you wrote): 



saveil tsg^rrr sQGtion (prioo; — ticdi L_caicL', deSciipLiun) . — 
v fil e - open ( Tt Llaiio a ct ions . tsrtrS — ILaJI ) 

i L ft-r w i i I . ht ( " % Pn 0 7 1 ] -n 1 G u \ i P" % frr- edi t_ca rd-7 — pi ice — * — f~ 60 , - doTcri ption) ) - 

-fv-om -bra*sa£lio*s ir*po\rt ^ 

items = [ "DONUT" , " LATTE" , "FILTER” , "MUFFIN"] 

prices = [1.50, 2.20, 1.80, 1.20] 
running = True 

while running: 
option = 1 

for choice in items: 

print ( str (opt ion) + ". " + choice) 

option = option + 1 
print ( str (opt ion) + ". Quit") 
choice = int ( input ( "Choose an option: ")) 
if choice == option: 
running = False 
else : 

credit_card = input ( "Credit card number: ") 

save_transact ion (prices [ choice - 1], credit_card, items [choice - 1] ) 
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The other program is very similar (which your friend created for use in the gym): 

— credi E_cara, Sdbci ipLluii) : 

* file = ' ujjuii ( "tran sac Lions . LxL ” , — " a ^i 

^Tiile . wiile ( "%07d%Tt>S%16s\n" % — tprice * TTJU7 creait_cdid; — d ig script ion ) ) 
rilu . close ( ) 

-from *ty3r\sad*tio^s ir*por*t ^ 

items = [ "WORKOUT " r "WEIGHTS " , "BIKES"] 
prices = [35. 0, 10.0, 8.0] 
running = True 

while running: 
option = 1 

for choice in items: 

print ( str (option) + ". " + choice) 

option = option + 1 
print ( str (opt ion) + ". Quit") 
choice = int ( input ( "Choose an option: ")) 

if choice == option: 
running = False 
else : 

credit_card = input ( "Credit card number: ") 

save_transaction (prices [choice - 1], credit_card, items [choice - 1]) 

Using a pencil, you were asked modify the two programs so that they use the transactions . py 
module. You were then asked to write what you think should go into the transactions . py 
module here: 



de-P save_jtransaction(priCe, Cred't__Card, description): 



-file =• open( w transactions.t*t W j VO 



ti I e . wr i*te ( u %07 d% I ^>s%l &s\n ;; % (pride ^ 1 00, dredt__dard, description)) 
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Tqst Drivg 



Once you have completed the exercise, you should have three saved 
files: gym_pos . py, cof f ee_pos . py, and transactions . py. You 
can now run the gym_pos . py and the cof f ee_pos . py programs: 

V- 



Python shell 



File Print FihpJI frehug nphon^ WmrinwR 



jjplp 



I'ytfton i.1.1 (rJll: HitfU, Aug 1H 2UU H J F UJiUisin) 

[CiC.r. 4,3*1] cm 1 i mix? 

Type ■" copyright " r "crcdita" or n Iiccnacil ) ■ lor more information- 
>» ================================ RESTART ==================== 



1 . WORKOUT 
2. WEIGHTS 

i. furls 
i. gu.it 

nhfjri.T^ rtTi opt inn: 1 

Credit: card number: &4J21214 12-17132 1 

1. WORKOUT 

2 . WEIGHTS 

a. allies 

i. Quit 

Choose an option: 4 



P 

Id 



Python shell 



file Edit SheJI Debug Qpthons Windows 



Help 



Python i.1.1 (rJlUHIHU 
[ftOO 4.3,1] nn liinix? 

Type "copyright", "credits" or 
>» 

1. DONUT 

2. LATTE 

3. FILTER 

4. JMIFFIH 

5. Quit 

Cll.l_iU9tf <±JI UpL 1-LJ1L : 1 

Credit cord numbers /b4!f4blU5b424J^ 

1 . donut 

2 . LATTE 
1. FILTER 
1 . nurriM 
5. Quit 

cnooES an option: 1 

>» f 



Aug IB 200 y, U/!Oji:35] 



HcenB0[ ) " tor more intormaCion . 
RESTART 



I n: 1 Tnl 



The two programs look like they've worked 
correctly. But what about the transaction file? 
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The transaction file is working great, too 



When you open up the transactions . txt file, you see this 

The descriptions -follow. (Note 

The r**fc b characters are the e*fcrt pad<M dwe tV>e 

I he first 7 characters. the Credit card number. "7o|i>s" -format specifier ) 

are the price- -V VT 



00035006432425412474321 




00001507649463856424326 



Both of the records, created by each of the POS programs, are now 
correctly formatted. That’s because both programs are sharing the 
same piece of code to save the transactions. 



Phew! I just heard from the 
bank that transactions from 
both of the POS systems went 
through smoothly. That's a big 
relief. Good job fixing it! 



Looks like you saved the day. 



there* ate no 

Dumb Questions 




% So modules are sort of like 
containers for functions, right? 



It's true that most modules are used 
to store a collection of related functions. 
However, it is perfectly acceptable to 
put any code in a module, which is then 
executed whenever the module is imported 
into your program. 



% So when I use import, it's as if I 
typed the code in the module directly 
into my program? 



Yes, that's a good way to think about 
it. Using a shared module saves you from 
having to type (or cut'n'paste) all that code 
yourself. J ust import it and it's there. 




Do I have to use modules? 



No, but the benefit of putting 
shareable code into a module starts to 
pay off the second you use that module 
in another program. Sharing code with 
modules is good programming practice. 
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price break 



The health club has a new requirement 

The health club boss has a grand plan to get more customers into the 
health club. 




Ooh, I think we need to discount the 
prices in the coffee bar for the next month. 
There's nothing like relaxing with a latte after 
a tough workout, especially if the price is right. 
Our customers like to treat themselves, so I 
want to make this easy for them. 



Instead of just amending the code in the 
cof f ee_pos . py file, you need to create a new 
module called promotion . py that will calculate 
a discounted price. 



the 

the 



The boss has a great new idea. 

The boss wants to cut 10% off all the prices in 
coffee bar. If it’s successful, he may want to do 
same thing in other places, such as the gym. 
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r / i ' ' ‘ 



You need to change the coffee bar POS program to apply the 1 0% 
discount to everything that's sold. You have three tasks. 



O 



Start by creating a new module called promotion . py containing 
one function: 



def discount (price) : 



e 

© 



Complete the code in the above function so that it returns 90% of the price it is 
given. 



This is the latest version of the cof fee_pos . py module. Modify it so that it 
uses the new module to cut the price of everything that's sold. 



from transactions import * 

items = ["DONUT", "LATTE", "FILTER", "MUFFIN"] 
prices = [1.50, 2.20, 1.80, 1.20] 
running = True 

while running: 
option = 1 

for choice in items: 

print ( str (opt ion) + " . " + choice) 

option = option + 1 
print ( str (option) + ". Quit") 
choice = int ( input ( "Choose an option: ")) 
if choice == option: 
running = False 
else : 

credit_card = input ( "Credit card number: ") 

save_transaction (prices [choice - 1], credit_card, items [choice - 1] ) 
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You needed to change the coffee bar POS program to apply the 1 0% 
discount to everything that's sold. You had three tasks. 



O 



Start by creating a new module called promotion . py containing 
one function: 



def discount (price) : 

return 0 P{ # pride 



Multiply^ ?' rite W °°l 

iwill $We you a 10% d.sdount- 



o 

o 



Complete the code in the above function so that it returns 90% of the price it is 
given. 



This is the latest version of the cof fee_pos . py module. Modify it so that it 
uses the new module to cut the price of everything that's sold. 



from transactions import * 

-Prom promotion import ^ ^ 

items = ["DONUT", "LATTE", 
prices = [1.50, 2.20, 1.80, 
running = True 



You need -to import the Lode. 

' trom the "pvomotion.py” module- 

"FILTER", "MUFFIN"] 

1 . 20 ] 



while running: 
option = 1 
for choice in items : 

print ( str (option) + ". " + choice) 

option = option + 1 
print ( str (option) + ". Quit") 
choice = int ( input ( "Choose an option: ")) 
if choice == option: 
running = False 
else : 

credit_card = input ( "Credit card number: 

* c w_pride— disdount^pridesCdhoide - IJ)^ 

save_transaction ] , credit_card, items [choice 

new_pr.de ^^Vw_ P Hde" is the disdounted value of the 



Your dode should 
dall the VisdountO' 

' -fundtion- 



- 1 ]) 

pride. 
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Tost Drove 



So what happens if you fire up cof fee_pos . py in IDLE and buy a $2 latte? 




It looks like it’s working on the screen. What about in the transactions.txt file? Will 
the latte still cost $2.20? 



The atW 
thav^e is heve 

No, the latte was discounted by 10% to $1.98, which is exactly what you 
want to record in the transactions file. 




It's time to demo your code to the boss. 
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another discount 





Both kinds of discount? 

It seems that there was something that the boss forgot to tell 
you. As well as deciding to cut the health club’s own prices, he 
also got in touch with his old friend, the GEO of Starbuzz, 
and arranged for a special discount for everyone who shows 
the cashier a Starbuzz Discount Card. This is the email he 
received back: 



Great to hear from you! 

• • thP Starbuzz discount scheme! A lot of 
Yes, of course, you can join the sta op tems for starbuzz, 

SHfe wT 

If we ever change the way ^ ^ systems 

Be well and keep drinking the coffee! 

Your friend, 

Starbuzz CEO 



That’s great news. Although you’ve heard about this extra discount 
late in the day, at least most of the work’s already been done for you. 
You just need to use the Python module the Starbuzz GEO attached 
to his email, and your program will be set up to apply both discounts. 

Let's take a look at the Starbuzz code. 
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The Starbuzz code 



The attachment from Starbuzz was a file called starbuzz.py. 
When you open it, you see this: 



# Official Starbuzz Discount Module 

# Copyright (c) Starbuzz Corporation 

# All Rights Reserved. 

# This function calculates a 5% discount on a price 
def discount (price) : 

return 0.95 * price 



Lihcs -that s-fcav-t y/i-fch 
# ave LototoCHts; Python" 
will ignore them. 



This is “the 
discount -function, 
as provided by 
S-tarbuzi- 



The first few lines begin with # characters; these are comments. 
Comments are just notes added by a programmer that are intended 
to be read by other programmers. Python will ignore them, because 
comments are not code. 




' This Wtoow returns a pride 
■that's l 5% lower than the pride it 
was given. 



After the comments comes the Starbuzz discount ( ) function. It’s 
just like the discount function you wrote, except instead of returning a 
10% discount, it returns a 5% discount. 



Your code will have to use both discounts: 



o 



It will apply a 10% discount to everything. 



And if somebody presents a Starbuzz Discount Card, it will also have to 
apply the 5 % Starbuzz discount. 




WAitX 



You need to change the code so that it uses both of the discount ( ) 
functions. Can you see a problem? What is it? 
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The two discount functions have the 
same name 

Here is the promotion . py module you just created: 



def discount (price) : 

return 0.9 * price 



And here is the starbuzz . py module: 



# Official Starbuzz Discount Module 

# Copyright (c) Starbuzz Corporation 

# All Rights Reserved. 

# This function calculates a 5% discount on a price 
def discount (price) : 

return 0.95 * price 



Both of the modules define a function called discount ( ) . So what 
happens when you try to use them? If Python sees a line of code like 
this: 

new_price = discount ( 1 . 75 ) 



which function will it call? The promotion discount? The Starbuzz 
discount? Both? Neither??? 

This is one of the problems of using shared code. Sometimes, there’s 
a function in one module that has the same name as a function in 
another module. When this happens, the last function imported is the 
one used, which has the effect of overloading any existing function 
that has the same name. This can result in to hard-to-find bugs. 

So what do you do? 

You need to somehow qualify your function names. 
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Fully Qualified Names (FQNs) prevent 
your programs from getting confused 



Imagine if you lived in a world where people had first names only: 




Lots of people share the same first name. But people also have 
surnames. If you use a first name with a surname, things are a lot 
less confusing. 



And it’s the same thing with code. If you have two modules 
containing functions with the same name, the computer will get 
confused. But if you fully qualify the function name, by prefixing 
it with the module name, the computer will know exactly what 
you mean: 

promotion . discount (1.75) 



If you are going to use Fully Qualified Names (FQNs) from a 
module, then you will also need to change the way you import the 
code: 




import promotion 



.This will import the Code -from promoWpy U 
bul to we it, you will need to add "promotion- 
it* fund-tio* name- 




coffee_pos.py 



Now you can fix the code to use both discounts. 
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M 



£oh£ ExeRciSe 



These are the two discount modules: 





# Official Starbuzz Discount Module 

# Copyright (c) Starbuzz Corporation 

# All Rights Reserved. 

# This function calculates a 5% discount on a price 
def discount (price) : 




return 0.95 * price 



Write a new version of coffee_pos .py that, after choosing a menu option, will ask if the 
customer has a Starbuzz Discount Card. If the answer is "Y", apply both the Starbuzz and the 
promotion discount. Otherwise, just apply the promotion discount. 



Here is the latest version of coffee_pos.py 



from transactions import * 
from promotion import * 

items = ["DONUT", "LATTE", "FILTER", "MUFFIN"] 

prices = [1.50, 2.20, 1.80, 1.20] 
running = True 

while running: 
option - 1 

for choice in items : 

print (str (option) + ". " + choice) 

option = option + 1 
print (str (option) + ". Quit") 
choice = int (input ( "Choose an option: ")) 
if choice == option: 
running = False 
else : 

credit_card = input ( "Credit card number: ") 

new_price = discount (prices [ choice - 1]) 

save_transaction (new_price, credit_card, items [choice - 1]) 
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M 



£oh£ ExGKaSe 
Solution 



These are the two discount modules: 






def discount (price) : 

return 0.9 * price 



stav-bi 



U2i.py 




# Official Starbuzz Discount Module 

# Copyright (c) Starbuzz Corporation 

# All Rights Reserved. 

# This function calculates a 5% discount on a price 
def discount (price) : 

return 0.95 * price 



You were asked to write a new version of coffee_pos.py that, after choosing an menu option, 
will ask if the customer has a Starbuzz Discount Card. If the answer is "Y", apply both the Starbuzz 
and the promotion discount. Otherwise, just apply the promotion discount. 

Here is the latest version of coffee_pos .py: 



— 

from transactions import * 

from promotion import * 

items = [ "DONUT" , " LATTE" , "FILTER" , "MUFFIN"] 

prices = [1.50, 2.20, 1.80, 1.20] 
running = True 

while running: 
option - 1 
for choice in items : 

print ( str (opt ion) + ". " + choice) 
option = option + 1 
print (str (option) + ". Quit") 
choice = int ( input ( "Choose an option: ")) 

if choice == option: 
running = False 
else : 



credit_card = input ( "Credit card number: ") 

new_price = discount (prices [ choice - 1]) 

save_transact ion (new_price, credit_card, items [choice - 1]) 
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By importing the 

tv-ahsaetiohs module like this, from trahsadtiohS import ^ 
you dan dall the -Pundtions 

without the module name. (. fXWption 





you need to use this kind ok \ 
import -for “pvomotion.py 
and u starbuzzW\ because 

you are going to qualify the .items. . . = CVOmV * . . FILTER" . 

•function names with the 



module names. 



prides ..=-. Cl .SO,. Z. 2 . 0 , .1 , 00 , .1,2-03 . 

running ~ .TXV^ 



whije running. 



option n | 



.•for. dhoide in items: 

pri P .t(str ( ?p ti on) + w , ” + dhoide) 



option ==■ option + I 
.py*i^t(str(option) + u , $uit* ) 



dhoide =7 .i.^t(input( ^Choose an. option: ”)) 
if dhoide — — option: 



running ^ False 



else: 



l-f someone has a 
Starbu^z. Disdount 
Card, you need to 
apply the sedond 
Starbuzi. disdount- 



dredit_dard =7 input( u Credit .^rd. number-; ”) 
pride .promotion, disdount^pridesCd — 1 3) 



. if. • ^P^tC'Starbuzi dard? ”) “Yj 

pride. = 7 ; .starbu^disdou^ 

sa ye_tra n sa dt i on (pri de , dredit__dard, .itemsCdhoide .-. 13) 
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test drive 




Tqst DriVq 



Let’s try running the new program and buy a $ 1.20 muffin without 
a discount card. 



•python shell* 



Eile Edit SheJI I2ebug Options Windows 



Python J.i.i (rJlliMIHU, Aug IB JOOB. 0 /: 0 Js-ii) 

[ftnn 4*3.1] L>n limix? 

Type "copyriqnt" r " credits" or " license [}" tor [tore information. 
RESTART — — ■ 

>> j 

1. DONUT 

2 . LATTE 

3. FILTER 

4. MUFFTH 
i . Uu it 

□ ini iJii-r it ii i i[i L. d 1 33i = h 

Uredit card number: SI 1 S /tiBi J!> fbH t 
fHrnrS>n7.T iTflrrl? N 




But what if you try to buy a $2.20 latte using a 
Starbuzz card? 




(^00010_854137 6585357 654 3 

li iosi fl oe - 10% ot fl.io. 



p 

Die Edit 



•Python shall* 



SheJI Djebug Options Windows 



Python J.i.i (rill&fUHUp Aug IB JOOy, UODJ:IS) 

[CtC-C. 4.1.1] on linux? 

Type “copyright" r "or edits" or "licence [] " tor rvore 1 n torraa t ion . 

- RESTART 



»> 




1. 


DONUT 


2. 


LATTE 


3. 


FILTER 


4. 


MUFFIN 


i. 


Uuit 


rimnyi+f rin 



U red it card numbers hi I i JO J 

Stftrhii77 arflrrl? V 




00001885413765835766543 



The code works! With the Starbuzz card, it applies 
two discounts. Without a Starbuzz card, your code 
just applies one. 
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The discounts get the customers flooding in 

Once word gets out that there are double-discounts available in 
the coffee bar, the health club gets packed with customers. 




We've never been so busy! The weight 
room, the gym, the steam baths. The 
whole place is full of customers! I like 
the way you write code. I want you to 
upgrade every system in the place! 



Thanks to writing modular code, you got the contract to 
replace all the health club systems. Modules help you write 
stable, maintainable code. The more code you write in modules, 
the greater the chance that you’ll be able to reuse it elsewhere. 



Breaking your code into modules turns good 
programs into great programs. 



tWeidre no 

Dumb Questions 



I don't get it; why do I need to use 
a FQN again? 

You use a Fully Qualified Name 
(or FQN) when you need to distinguish 
between two functions from different 
modules that have the same name. 

With the health club systems, the 
discount ( ) function existed within 
your module and within the one supplied by 
Starbuzz. In order to keep things straight, 
you had to use a FQN. 



So if I hadn't used a FQN, the 
wrong discount is applied to the 
purchase? 



A 



I Yes, most probably. 

But if I hadn't used a FQN, how 
would I know which discount was used? 



Well... that's the problem. You 
wouldn't. It's hard to predict what would 
happen, because it all depends on which 
order the code imports its modules. 



% So, all I need to do is keep an eye 
on the order when I import modules and 
everything will be OK? 



No, that's not what we recommend. 
Don't rely on what might happen. Use a 
FQN so that you are always in control. 
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CHAPTER 6 



programming toolbox 




Your Programming Toolbox 

You've got Chapter 6 under your 
belt. Let's look back at what 
you've learned in this chapter: 
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Your coding skills are great and getting better all the time. 

It’s just a shame your programs are not that nice to look at. Displaying prompts and 
messages on a text-based console is all well and good, but it’s so 1970s, isn’t it? Add 
some green text on a black background and your retro look will be complete. There has 
to be a better way to communicate with your users than the console, and there is: using 
a graphical user interface or GUI (pronounced “gooey”). Sounds cool, but complex, and 
it can be. But, don’t fret; learning a trick or two will have your code all graphical in no time. 
Let’s get all gooey (sorry, GUI) in this chapter. 
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a host of requests 



Head First TVN now 
produces game shows 

It’s more than just sports at Head First TVN, as the station has 
entered the lucrative world of live game show broadcasting. 

Their flagship show, Who Wants to Win a Swivel Chair , is attracting 
viewing figures in the millions... not bad for a station that operates 
on a shoestring budget. 

You’ve been approached by their stressed-out (but incredibly 
smooth) game show host to help with a program he needs. TVN 
was so impressed with your work last time that they are offering 
two free, front-row tickets to the Grand Final as payment for your 
work. 




You’ve had a few conversations with the host and determined a 
list of program requirements'. 

1 . The host wants to be prompted after a question has been asked 
to press either 1 for a correct answer or 2 for a wrong answer. 

2 . Based on the key pressed, an appropriate sound effect needs to 
play. 

3 . The program needs to remember how many answers were 
correct and how many were wrong. 

4 . The host will end the quiz by pressing 0. Then the program 
will display the number of right, wrong, and asked questions. 



Let's flesh out what's required in pseudo-code. 
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Use the space provided below to write the pseudo-code for the 
program you've been asked to write for TVN: 
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game show pseudo-code 




You were asked to use the space provided below to write the 
pseudo-code for the program you've been asked to write forTVN: 



You need to remember boy/ 
many questions were asked; 
boy/ many were dorredt, 
and boy/ many y /ere wrong. 



f number asked — O 

) ~ 

number dorredt — 0 



number__wrong — 0 



, t ^ ask tbe host to press I -for dorredt; 2. -for indorredt; or 0 to end 

Begin by asking tbe ^ ^ 

host “to make a dboide- v/bile tbe host response is not 0 

i-P host response_y^as I 
"add I to number asked 

rrr 

This will run ^ add I to number dorredt 

v,as ansy/ered CORRECTLY - 



play a sound e-P^edt 
i-P host response y /as Z 

I to number asked 



This will run 

tbe ^uest^ add I to number__wrong 

was ansy/ered • • • ^ J ' 

INCORRECTLY- .XsPjay a sound 



Ask tbe host at tbe 
end o-P eadb loop wbat 1 
be wants to do next- 



fina\ly» display 

tbe sdores. 



Don't worry i-P y ou r answer 
doesn't look EXACTLY like 
this. There are a -Pew ways 
o-P writing tbe dode. 



^ ask tbe host to press I -for dorredt; Z -for indorredt; or 0 to end 

display tbe values o-P number_asked> number__dorredt and 
number^ wrong on sdreen 
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Frank: I think sound is going to be a problem. 

Jim: Sounds easy to me... 

Joe & Frank: <groan>. 

Jim: Sorry, couldn’t resist that one. Seriously, though, how hard can 
it be to play a sound from a program? 

Joe: Playing a sound is not the problem; getting it to work on 
multiple platforms can be. For instance, what works on Windows 
might not work on Mac OS X or Linux. 

Jim: That’s not a problem. I only use Windows, so I’ll be OK. 

Frank: Good for you, but the rest of us want to play, too, and we 
don’t want to have to... um... eh... downgrade to Windows. 

Jim: Typical: have a swipe at Windows when something doesn’t 
work on your non-Windows computer. 

Joe: Cool it, guys. We need to stop bickering and come up with a 
solution that lets us play sounds and works on Windows, Mac OS X, 
and Linux. And it has to work with Python, too. 

Jim: You mean Python doesn’t support sound as standard?!? 

Frank: No, not really. In fact, very few programming languages 
support sound in a cross-platform way. This isn’t just a Python 
problem. 

Jim: So... we’re outta luck then. Does that mean it’s time to go 
home? 

Joe: Not so fast, Jim! I’m pretty sure pygame can help here. 

Jim: So... I can’t go home early, but I can play games? 

Frank: Seriously, Jim, I think Joe’s right. We can use pygame to 
play our sounds in Python. 

Jim: And it’ll work on Windows, Mac OS X, and Linux? 

Joe: Yes, I’m pretty sure it will. Granted, pygame ’s a set of gaming 
libraries for Python, but all we need to use is the bit that handles 
playing sounds. 

Jim: Sounds great. I can’t wait to see it in action. 

Frank: Didn’t you mean “ hear it in action”? 

Jim & Joe: <groan>. 




f>ahk Joe 
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get in the pygame 



pygame is cross platform 



Before continuing with the rest of this chapter, you need to take 
five to download and then install the pygame technology onto 
your computer. The pygame technology is an example of what’s 
known as a third-party library : that’s extra functionality that can be 
added into your Python environment, but which isn’t part of the 
standard library 




As installing pygame tends to be a very platform-specific 
thing, we’ve uploaded a set of instructions onto the Head First 
Programming website for you to follow. 



STOP! Don't proceed with the rest of this chapter 
until you've installed pygame for Python 3 on your 
computer. 
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Reaps Bane 
0>pe 

Take a look at this handy pygame program, which shows how to play 
four sounds one after another: 



Just like with other 
libraries, you import the 
library you want to use 



Create a 'pygame. mi*er” object 
and initialise the sound system. ^ 

The u waitjfinishO w 
tundtion loops until the 
dhannePs w gctjbusy() w 
method returns False- 



The value returned -Prom ^ 
the w playO w method gets 
passed to W wart_ «finishO". 



import pygame. mixer 
[sounds = pygame. mixer 
[sounds . init ( ) 

def wait_finish (channel) : 
while channel . get_busy i 
pass 

s = sounds . Sound ( "heartbeat . wav” ) 
wait_f inish ( s . play ( ) ) 
s2 = sounds . Sound ( "buzz . wav" ) 4 
wait_f inish ( s2 . play ( ) ) 
s3 = sounds . Sound ( "ohno . wav" ) 
wait_f inish ( s3 . play ( ) ) 
s4 = sounds . Sound ( " carhorn . wav" ) 
wait_f inish ( s4 . play ( ) ) 



L The U get_busy(T 
method ehedks to 

\ see i-P the so[ay\A 
is still playing. 



,%ass” i* a 

tv»at 

does nothing* 

Load in the 
sound -Pile you 
want to play. 

Identify and play 
eadh o*P the sounds. 




To run this program on your computer, you obviously need pygame installed and you 
need to download the sound files for this chapter from the Head First Programming 
website. Be sure to put the sound files in the same directory/folder as your program. 
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test drive 




Tqst DRII/e 



YouVe successfully downloaded/ installed pygame and grabbed a copy of 
the Head First Programming sound files for this chapter. Now, test the pygame 
program in IDLE to see if things are working correctly: 



\ / / 



o 1 ^ 

^Buzzf - — 

I \^~ 

\ ' ' 

Oh no! — 

' I 

^Beeeep! — 

Sounds like pygame is up and running! / 

I \ 






mc £<a* t 

o\ay\A »* 
but trust 
-ogra** 
rilled- U 
NT trust 
ic suve t> 
^vo^v-aw 
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% So pygame is a library created 
by some programmer other than the 
Python folks? 



Yes, it's what's called a third-party 
library. It wasn't created by you or the 
people that bring you Python. Some other 
programmer(s), a third party, created 
pygame. 




And it's just given away for free? 



Yes. Which is very nice of them, isn't 
it? 



% Are there other libraries like 
pygame that can be added into my 
Python environment? 



Yes, there are lots. To see the current 
list, follow the Package Index link from 
the main Python website. Python refers to 
third-party libraries as "packages" and, as 
you'll see, there are packages available for 
every conceivable purpose, not just playing 
sounds or developing games (as is the 
case with pygame). 



% The sounds I downloaded are 
WAV files. I know that WAV is one of the 
standards for encoding sound, but is it 
the best format to use? 



That depends on who you ask! We 
are using WAV files because they are used 
in lots of places and are well-supported on 
most operating systems. There are lots of 
file formats for sound and many of them 
claim to be "better" than WAV, but for what 
we are doing here, WAV is perfect. 



iWeiare no 

Dumb Questions 



% What's the deal with the wait_ 
finish!) function in the Ready Bake 
Code? I just don't get why it's there. 



It's a function that waits for the sound 
to finish playing before continuing with the 
rest of the program. 



% 

plays? 



What? ! Surely the sound just 



Playing with pygame in this way, 
although fun, masks a problem that can 
surface when working with sound (in any 
programming language). It turns out that, 
when asked to play a sound, the main chip 
inside your computer (the CPU) doesn't 
even bother trying. Instead, there's another, 
smaller chip in your computer that is 
specifically designed to play sounds and 
it is to this chip that your main chip hands 
the sound file to and says: "play this for 
me." The main chip then goes back to 
running your code, sees another request 
to play a sound, doesn't bother, hands 
the new sound file off to the sound chip, 
and repeats until your program ends. The 
sound chip-and this is the important 
part- is designed to operate in parallel 
with your main chip. While your main chip 
is doing something else, the sound chip is 
busy playing any sounds it has been asked 
to play. And- here's the rub- if the sound 
chip has been asked to play more than one 
sound, it attempts to play each sound at 
the same time. 



% So the wait_ finish!) function is 
like an artificial delay after each sound? 



No, not really a delay, more like a 
pause designed to let the sound effect play 
fully before trying to play anything else. 

The wait_f inish ( ) function forces 
your sound chip to finish with one sound 
before starting another. What happens is 
that when a sound is played, the play ( ) 
method passes back the channel (or track) 
numberthatthe sound is playing on. You 
can then use the channel number to ask 
pygame to wait for the channel to finish 
playing a sound before continuing, which 
is what the code in the Test Drive on the 
previous page does. 



% And if I don't use wait_ finish!), 
what happens then? 



All the sounds attempt to play at the 
same time and it sounds like a jumble of 
sounds as opposed to one sound playing, 
then another, then another, and so on. 
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beyond pseudo-code 



M 



£oh£ ExeRciSe 



Now that you know how to generate a sound using pygame, it's time to write the code for 
TVN's program. Base your program on the pseudo-code you created earlier. 
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on with the show 



M 



£ong ExetdSe 

§OLutlOrt 



Now that you know how to generate a sound using pygame, it's time to write the code for 
TVN’s program. You were to base your program on the pseudo-code you created earlier. 



Yw need -to 

p\Hxan>e’s Vi*ev module — . 

w a . , -i... sow ds. ^.. ,m ? or i?W ne r ,ce .' r . 



ovdev- -to ?'ay 



«J^ e de-f 'wai‘t_-f mish(dhannel) : 

-f'ronv while tharmeUet busyO: 

earlier. 

pass 



Create a mi%er object 

and mitialiZjC the ^ sounds =■ f.Y9 amCr * , * cv " 

pygame sound system. 

sounds. initO 



Load eadh ot the 

required sounds into its ^ dorredtjs =■ sounds.£ound( U dorredtwav ; ) 
own variable. 

wrongs sounds.Soundt wrong.wav / 

This is what you'll 
ask the question 

master eadh time. . Mrs , * „ , „ n . , ^ , » 

prompt — Press I tor Correct, 2. tor Wrong, or 0 to $uit : 

Make swve the took ; that 
Wll ma'wtaift av-e set to a 

v-easonahle stav"fci*»5 va we ' ^munnbev- asked — 0 

J number__dorredt =• 0 

It would be OX to move these ( number__wrong — 0 
three lines ot dode to the top 
ot the program, just so long as 
they have starting values betore 
the while loop starts. 
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Prompt the host. 






\A/Wilc “tV^c ^a^e y\)]\c. Ah?!^!r. K Q*.: 
hasn't ended- - 

tp dhoide 

l-P the answer is 

dorredt, increment “the . . .^mber_asked. + .( 

Counters and then play 

the appropriate sound ^P^oyrtct ~ .^umber_dorredt . + I . 

wa i.'L'f p.i.^b !• A pjota At_? : p.la.yO) 

|*P the answer is 

indorredt* indrement rrrrr^.'^. 

the dounters and play 
the sound e£Pedt- 



number^a ske d ^ r^^be\r_asked + I 

u*nr\b CV7 v/)r 01^ ^ =1 nu^.^.^^lr.?!?^. ."t. .( 

wait_Pi nish (wr on^s.p jay ( ) ) 
dhoide =7 



r>: 



display a summary <* the 

dounter values- 



print( u you asked ” + .*t. ^estions ;; ) 

print(str(number__ dorredt) + w were dorredtly answered 
print(str(number^wron<}) + w were answered indorredtly”) 
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test drive 




Drove 



Type your code into IDLE and save it under the name game show . py. 
With the Head First Programming sounds stored in the same directory as your 
program, press F5 to give it a spin. 




|/\fe tan t show 
these sounds 
either, so 50 
ahead and run 
the pro^ra** to 
hear it working 
-for yoursel-f- 
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pygame Exposed 

This week’s interview: 

Is it fun being pygame? 



Head First: Hello, pygame. Nice of you to join us. 

pygame: Hello. Thank you so much for giving me 
this opportunity to discuss my situation with you. 

Head First: What situation is that? 

pygame: Well, you know, just because I’m used for 
gaming, everyone expects me to be fun all the time. 
Life and soul of the party... never stopping to smell 
the roses... always on the go. <sigh> It’s all too much 
fun, really. 

Head First: Too much fun? Really?!? 

pygame: Well... yes. Not a lot of people know this, 
but my life as pygame is hard. Not only do I have 
to help out regular folks with their programming 
problems, but there’s all those gamers, too. Some of 
those guys never sleep... it’s just play, play, play, play, 
play, play... I’m simply exhausted. 

Head First: Oh, sorry to hear that. But, don’t you 
feel good that all those programmers out there in the 
Python community are using you? 

pygame: I guess so. 

Head First: You’ve made a lot of programmers’ 
lives easier. There’s lots of great code written that 
would not have been written if it weren’t for you. 

pygame: Yeah, right. I do all the heavy lifting while 
everyone else is off doing other things. 

Head First: Ah, come on, your life’s not that bad, 
is it? 

pygame: <sighs> 



Head First: Surely you know what people are 
saying about you? 

pygame: Now they’re talking about me, too? How 
awful... <sobs> 

Head First: Yeah, there’s lots of talk, but it’s all 
good. The Python programming community loves you, 
pygame. 

pygame: They do? <sobs even more> 

Head First: Yes. You are well-tested, well-written, 
and your documentation is first rate. Your support 
for all the major releases of Python is right on the 
money, too, and you work on Mac OS X, Windows, 
and Linux. 

pygame: All I’ve ever tried to do is keep everyone 
happy. 

Head First: And you do. We’ve heard so many 
great things about you that we are recommending 
you to all our friends. 

pygame: Do they play games? I’m good at that, you 
know. 

Head First: Yes, some of them do. But others just 
talk about the great things their applications can now 
do thanks to you, pygame. 

pygame: I guess things aren’t quite so bad after all? 

Head First: Not at all. We’re big fans! 

pygame: Why, thanks. That’s awesome. Do you 
have time for a quick game? There’s this new 
Dungeons and Dragons that I’ve been dying to try... 
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dated interface 



0 ... 1 ... 1 ... 9 ... blast off! 




Your program's looking pretty dated. 

The program works, but it’s not going to win a Visual 
Design Award any time soon. And its use of key presses 
makes it a little hard to use, too. 

So, its looks could be improved and its usability could be 
better. 



It sounds like you need a graphical user interface , or GUI. 



Most people pronounce djU| 
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You need to design the look of your GUI forTVN. Draw what you 
think your GUI should look like in the space provided below. 

Hint: Take some time to think about other GUI programs that you 
have used. Think about a common interface element that you 
could use (and draw) here. 
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interface facelift 
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Frank: Since when have you been an expert on GUIs? 

Jim: Isn’t every Windows user? 

Joe: Well, of course, everyone knows how to use a GUI, but we are 
talking about creating a GUI in code. 

Jim: Ah... oh... um... eh... now, where shall we start? 

Frank: It turns out that writing code for a GUI application is... 
well... just like writing any other code. If you know how to program, 
you know how to create a GUI. It’s just a matter of selecting the 
correct GUI library, learning how to use it, then writing the code. 

Joe: So we’ll head off to the Python Package Index and grab us some 
GUI libraries, eh? 

Frank: Not so fast. Python comes with a GUI library as standard, 
called tkinter. 

Jim: tk-what? 

Frank: tkinter. The “tk” bit refers to the fact that Python’s standard 
GUI library is built on top of the very popular Tk technology. The 
“inter” bit is short for “interface.” 

Jim: So we’re going to build a GUI interface in Python running on 
Tk using tkinter? 

Frank: Yes, we are. That’s not too confusing, is it? 

Joe & Jim: Well... not if you say so. 

Frank: The big thing with creating GUIs is understanding the event 
loop. 

Joe: Ah, that’s just looping code that reacts when certain things 
happen, isn’t it? It’s just like the while loop in the non-GUI version 
of TVN’s program. In that code, that loop is an event loop, isn’t it? 

Frank: It sure is. Although the GUI event loop tends to be extra 
capable and can do lots more than the simple while loop. 




Joe: That sounds complex. Is it? 



Frank: No, not really. It just takes a little getting used to. 



Jim: But, it’s all just code, isn’t it? 



Frank: Yes, Python code using the tkinter library. 



Joe: OK. Let’s get to it, since we already know how to program... 
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tkinter event loop 



tkinter gives you the event loop for free 

In order to process events efficiently, GUIs employ an event loop. Event 
loops watch and wait for events, calling a piece of code each time an 
event occurs. If you think about the current TVN Game Show program, 
it already has a very basic event loop that waits for the host to press 1,2, 
or 0. The program then calls some code before waiting again for another 
key -press event from the host. To implement this in code, you used a while 
loop: 



while choice != 'O': 
if choice — ' 1 ' : 

number_asked = number_asked + 1 
number correct = number correct + 1 



In tkinker, you don’t need to write a while loop like you did for your 
non-GUI program. In tkinter, call the main loop ( ) method instead: 



Cli£k oh -the dose 

box -to terminate 
^is appli£a-fci< 



CiOh. 



fy VC -the 
window a 
name. 



Import everything -from 
the tkinter module- 

-V 



T 



from tkinter import * 

Oeate a tkinter action 
app = Tk ( ) £“* window tailed 3?? * 

app . title ( "Your tkinter application") 




>>app . geometry ( ’450x100+2 00 + 100’ ) 

Provide 'winaov.- app.mainloop ( ) 
toov-dinates an 



These twe lines o£ 
Python/ tkinter tode 
yv-odute this ^w|. 



SiZ-C 



values- 



Start the tkinter eveht loop. 



To add a button to your application, use code like this, being sure to put 
these two lines of code before the call to main loop ( ) : 
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tkinter is packed with options 



The pack ( ) method lets you position the button in the application 
window. If you provide a value for the side parameter to pack ( ) , 
you can control where in the window the button appears. Here are the 
legal values for side: 



o 

o 

o 

o 



pack(side = 'left') 

Position the button on the left side of the window, 
pack (side = 'right') 

Position the button on the right side of the window. 

pack (side = 'top') 

Position the button at the top of the window. 

pack (side = 'bottom') 

Position the button at the bottom of the window. 




The value ot "side" 
Controls where the 
button Is packed. 



It is also possible to add some padding around buttons (to make them 
look nicer in your window): 



o 



pack (padx = 10, pady = 10) 

Position the button with 1 0 pixels padding on all four sides. 



_ Jharpfin your pencil 



Based on what you now know about tkinter windows and 
buttons, write the code to display the GUI that you need for the 
TVN program: 
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gooey display 



Sharpen your pencil 
Solution 



Based on what you now know about tkinter windows and 
buttons, you were to write the code to display the GUI that you 
need for the TVN program: 



in\p?y;t 



Oeate the window as 
in the earlier example, 
but than$e the window ^ 
title and geometry 
values. 



Taff. = TkO 

.WiM Marine £how ,; ) 

.app.geornet 



Create a button tor 

Correct event. bl =- Button(app ; te>t. ^ "Correct!”^ width ~ 10) 

Paek one button .... t ) .(.P^k(side. ; . Jett >. pad* \0 Jm pady — J.Q). 

on the lett> the z' 

other on the v-i^ht / 

padd" ^ . . b.?r . r 1 Button(app ; . te*t ^ ^Wy-ongf^ width I 0) 

Cveate another button t?:-.padk(side. . Vijht',. pad* =: . ! <?.>. pady. . ! Q). 

be ti*e 1M’ ^ 



Start the event loop — 
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Tqst Drii/q 



Let’s take your first GUI program for a test drive. With your tkinter code 
entered into IDLE, save it as t vn . pyw and press F5 to see how it looks: 



^>uv~ dodc in IPLt 



There's a Convention in the Python 
world -that suggests naming tkinter 
• programs with a "pyw" e*tension, 
as opposed to the usual py ■ This 
helps your operating system run your 
tkinter programs properly, especially on 
1/Vindows. 



M tvn.pyw - /home/barryp/p_sounds./tvn.pyw 


t* _ n 


m 


| File Edit Format Run Options Windows 


Help || 



from tkinter import * 
app = Tkj ) 

app. title ( "TYN Game Show" 1 ) 
app. geometry { ’iOOxlOO + 200-rIOO 1 ) 

bl = Button(app r text = "Correct ! 11 r width = 10) 
bi. pack {side — ‘left , padH — 10 , pady — 10) 

b2 = Button (app, text = "Wrong! 11 , width = 10) 
b2 . pack (side =■ right 1 , padx = iu, pady = 1U) 



app.mainloop( ) 

I 



There's your djU| window.. 



Looking good, eh? 







..and there are 

your two buttons. 



That's one nice, professional-looking GUI! What do the 
people at TVN think? 
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beauty without brains 



The (rUI works, but doesn't do anything 




Nice interface, but it doesn’t work. 
When I click on a button, nothing 
happens... I don’t hear anything. What 
happened to my cool sound effects? 



The graphical user interface might 
be ready, but the program is not 
complete. 



there .are no 

Dumb Questions 



O: So all tkinter gives me is the ability to draw the GUI? 

Well, yes, but there's quite a lot of functionality wrapped up in 
that small number of lines of tkinter code. 

O: That pack ( ) method looks a little weird... how does it 
know where to put things? 

The pack ( ) method adopts a best-guess approach when 
it comes to packing your GUI widgets within your GUI application 
window. This usually works out, and when it doesn't, pack ( ) 's 
parameters give you some control over the situation. 



O: That's all that left, right, top, and bottom 
stuff, isn't it? 

Yes, as well as the padx and pady parameters. They 
help with widget positioning, too, by putting additonal space (or 
padding) around your buttons. 

% OK, I get that, but how come nothing happens when I 
click on my buttons? 



Ah, 



funny you should ask that... 
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Connect code to your button events 

When you click on a button, the tkinter event loop captures the event and 
looks for something to do with it. The trouble is, as your program stands, you 
have not detailed what that something to do is. Your buttons have no code 
associated with them, so the events occur but go unnoticed. To connect code to 
buttons, put the code you want to run in its own function and then name the 
function in the button code by providing a command parameter: 



Identity "the -function to run when 
"the button is disked- 



b = Button (app, text = "Click on me!", width = 15, command = button_click) 
b.pack(padx = 10, pady = 10) J 

Wc® 




y' 



I \ 



Create a -function to Contain 
the dode that runs when the 
event odours. 



def button_click ( ) : 

print ("I’ve just been clicked!") 







kicked.. 



utt.pyw - ,hom&;barryp. , p_EOLindfi l 'biJ 



Bun Options Windows 








app - TKM 

npp a. ti tl r ( " f! I l rV nn rv^ 11 ) 
app r geometry [ '100x100*200+100 



Z Put tem_e licit [ ) i 
pr int ( * 1 1 vc J u □ t been clic ked ! ■ ) 



h - But ton ( app , text - "Click on t t.c',* , width - 15, command - button__click) 
1 > . U-ii.' k f L . 1 a i jl = 10 , £Jid y = 10 Jl 

rtp[j . r.ri i ulitngj ( j 



’Python shell* 



Flip Ijiit r.hpll r^phufj Options Wndow*! 



1'ythlm i . .1 . £ (rJll:J£4BU F Aug iti 200y, D7xUJ:4S} 
un 1 i rim? 

Type copyright " F "credits” or “liccn3c(] " tor more in lormatiem . 

===== RESTART == 

»> 

T ' vti Ju^L. tiMi-in c:l l 1 
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making connections 




The code from the nongraphical version of theTVN program is on 
this and the facing page. Take your pencil and mark the parts of 
the code that you would extract and turn into functions so that 
you can then connect the functions to the buttons in your GUI. 
Mark the other parts of this program that also need to be added 
to the GUI version. 



The nature the 
intev-Cafce provided by the 
6jU| means that Some ok ~ 
the program's requirements 
have thanked- 



Note: Don't worry about prompting the host to ask a question in 
the GUI. But do worry about maintaining a count of the number 
of questions answered correctly and incorrectly. (The total count 
is not important, either.) 



How many functions do you think you need? Write their names here: 



import pygame. mixer 

def wait_finish (channel) : 

while channel . get_busy ( ) : 
pass 

sounds = pygame. mixer 
sounds . init ( ) 

correct_s = sounds . Sound ( "correct . wav" ) 
wrong_s = sounds . Sound ( "wrong . wav" ) 

prompt = "Press 1 for Correct, 2 for Wrong, or 0 to Quit: " 

number_asked = 0 
number_correct = 0 
number_wrong = 0 
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choice = input (prompt) 
while choice != f 0 ! : 
if choice == ’ 1 ’ : 

number_asked = number_asked + 1 
number_correct = number_correct + 1 
wait_f inish (correct_s . play ( ) ) 
if choice == ’ 2 ’ : 

number_asked = number_asked + 1 
number_wrong = number_wrong + 1 
wait_f inish (wrong_s . play ( ) ) 
choice = input (prompt) 

print ("You asked " + str (number_asked) + " questions.") 
print (str (number_correct) + " were correctly answered.") 
print ( str (number_wrong) + " were answered incorrectly.") 



With the code you need identified, take the time to update 
your GUI application with the new functions and whatever 
other code you've extracted from the non-GUI program. 

Produce a new program that is a combination of your existing 
GUI code and the extracted code from this program. 
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page goal header 




You were to take your pencil and mark the parts of the code on 
the previous (and facing) page to identify the code you would 
extract and turn into functions so that you can then connect the 
functions to the buttons in your GUI. You were also to mark the 
other parts of this program that also need to be added to the GUI 
version: 



You were to think about how many functions you might need. You 
were to write their names here: 



play_dorredt_soundO 



You need a -function to play_y/V-oh^_sour\dO ^ ...and another -function 

play a sound when "the to play a sound when -the 

answer is eorredt- answer is wrong. 





The £jU I program still 
needs to use pygame. 




correct_s = sounds . Sound ( " correct . wav" ) 
wrong_s = sounds . Sound ( "wrong . wav” ) 

prompt = "Press 1 for Correct, 2 for Wrong, or 0 to Quit: " 



nnmhpr a .qtpd _ 0 
'fumber_correct = 0 
number_wrong = 0 




You still need to maintain 
these Counters. 
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choice = input (prompt) 
while choice != ’O': 
if choice == ’ 1 ’ : 

nu mber ask ^H = nnmhpr + 1 

number_correct = number_correct + 
iit_finish (correct_s .play i 
if choice == ’ 2 ’ : 

numb er asked = number asked + 1 
number_wrong = number_wrong + 1 
iit_f inish (wrong_s . play ( ) ) 
choice = inpuf 





this dode m-to the 

"play ^dovredt_s°uir\d( ) 

lufidtiorv 

h>S Code tte 

^ P«y_woh LsouhdO" 
tuhdtioh. 



print ("You asked ” + ^r/nnmhpr + » r|iipqfinpq ’M 




l^~ Displaying the 
sumw>avy ve^ams a 

re c \uiv'einney>t, too. 



With the code you need identified, you were to take the time 
to update your GUI application with the new functions and 
whatever other code you've extracted from the non-GUI 
program. 

You were asked to produce a new program that is a 
combination of your existing GUI code and the extracted 
code from this program. 



he pa 9e 

<*?daied Code solution. 
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button press rehearsal 



The GUI program's how ready for 
a screentest 

Here’s what your GUI program should look like now: 
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Tost Drove 



With the code you need extracted from the nongraphical application and 
added to your GUI program, press F5 in IDLE to see (and hear) if things are 
working any better now: 



7VN Gam* show 






Tmg! 

I \ 



Corrw.L! 



It not only looks 
opo&, Wt 



it 




Every time you click on a button, the appropriate sound 
effect is heard. Great work! 



thev&iccce no 

Dumb Questions 




So "event handlers" in tkinter are just functions? 



Yes, as we said earlier in this chapter: it's all just code. And 
by putting the code you want to run in a function, it's easy to 
reference it using the command parameter associated with each 
button. Your user clicks the button to run the code in your function. 



This actually isn't too hard. I always thought building a 
GUI was only for advanced programmers? 

Well... that certainly used to be the case, but things have 
changed (for the better). Technologies like tkinter allow every 
programmer to build great-looking GUIs without too much fuss. It's 
a case of tkinter concentrating on the GUI, while you concentrate 
on your code. 



% And is it the case that, if I want to add other things to my 
GUI program, it's done in a similar way? 

Yes, all you have to do is write the code. 

% And I connect my code up to my other things using 
something like the command parameter that works with 
buttons? 



Yes, that's all there is to it. The mechanism for the other 
interface elements (or widgets, for short) might be a little different, 
butthe concept is the same. Once you can work with one, the rest 
are a lot easier to get your head around. 
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missing resuits 



Put TVN is still not happy 



The sounds work great, 
the GUI looks fantastic... 
but where are my results? 
I can't find them! 



The results appeared in the Python Shell, 
not in the GUI, so the host missed seeing 
them. When you point this out to him, he’s 
less than impressed and makes it clear that 
he expects the results to appear in the GUI. 



You need some way to display 
messages in the GUI. 



The results ave 
y-ioyht -there in the 
Python Shell- But 
this is NOT what 
the host wants. 
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+ 






VWWAT* 




* 






The interface elements that you add to a GUI are known as widgets. 
You’ve met one already: the button. There are lots of others. Look at 
the names of some other widgets below and see if you can match them 
with the correct description. We’ve already done the first one for you. 




A widget that provides a way for large and 
small amounts of text to be entered 



A separate window that pops up to request 
additional information from the user 



A widget that displays a string message in 
a window 



The combination of a drop-down list and 
a text box 



A widget that allows you to select one item 
from a large list 



Dialog box 



A list of command options that is attached 
to the top of a window 



lA/v-'rtc youv 
d nswev hev-e 



Which widget do you think you need to use in your program? 
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+ 






VWWAT* 




* 









The interface elements that you add to a GUI are known as widgets. 
You’ve met one already: the button. There are lots of others. You were 
to look at the names of some other widgets below and see if you could 
match them with the correct description. 




A widget that provides a way for large and 
small amounts of text to be entered 



A separate window that pops up to request 
additional information from the user 



A widget that displays a string message in 
a window 



The combination of a drop-down list and 
a text box 



A widget that allows you to select one item 
from a large list 



A list of command options that is attached 
to the top of a window 



You were asked to identify which widget you would use in your program. 

Use -the “Label” widjjeL 

You need -to add a label -to your (\\A\ m 
order -to display tbe results- 
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Label it 



When it comes to adding a label to your GUI, use the tkinter Label widget. 
You create it in code not unlike the way you create a button. Here’s the code 
to add a label to an existing GUI application. The label simply displays a 
string: 






Create a new label) attafcb 
it to tbe «>am window, 3 '«ve 
it some tent, a»d adjust tbe 
label’s height- 



1 = Label (app, text='When you are ready, click on the buttons ! ' , height = 3) 
1 . pack ( ) 







Don’t -forget to paekO the widget- 



Pwt the label tode before 
the tode tor the buttons 
and the £jl/l will then look- ^ 
like -this. 



tvw Gam* show 



When you are ready, chcfc on the 



Correct! 



he buttons! 
Wrong! 



Another variation replaces the text parameter with text variable. If 
you assign a special tkinter variable to this parameter, the label will change 
whenever the value of the variable changes, automatically : 



Create an IntVar * 



Assoc iate _ 
the u /ntl/ar” 
with the 
label. 



num_good = IntVar() 
num_good .set ( 0 ) 

11 = Label (app, textvariable = num_good) 
11. pack (side = 'left') 



num_good .set ( 100 ) 




W | C ih C ± e ^?' rr ' e ^ od adjust -the 
value of the Intl/ar", and the 6,UI 
updates, as \\ by r*agie. 
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Exercise 

m 



Based on what you now know about adding a label to a GUI, 
rework your GUI code so that it uses two labels. One should 
display the number of correct answers and the other should 
display the number of wrong answers. We've left plenty of room 
for you to write in all the code that your program now needs. 
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label results 



M 



£ oh $ EmctSe 
Solution 



Based on what you now know about adding a label to a GUI, you 
were asked to rework your GUI code so that it uses two labels. 
One should display the number of correct answers and the other 
should display the number of wrong answers. We left plenty 
of room for you to write in all the code that your program now 
needs. 



Start by importing the ^frorn tkinter import ^ 
library Code you need- ') 

^import PY^me* mixer 



Create the two 
event handlers 

that set the ^ - 

|nt\/ar and play 
the appropriate 
sound- 



de-f play^dorredt^soundO: 

num aoodset^num <\ood<\etO + I) 

J. * I J. 

.^V^f^splayO 



de-f play^wron^soundO: 

num^bad.setfnum^bad.getO + I) 
wrong^s.playO 



app^TkO 

apptitleO^T' 



Create the ^|_ ^ a P F title("TVK ^a-e Show") 

application window- , - 1 



Initialise the 
sound system" 



sounds ^ pyjamemixer 
. sounds initO 
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. . , f Corred s — sounds.SoundC'con-efrt-'wav”) 

'retired sound - ^ J — 

y/voir\^_s — sounds-Sound( v/v-on(j.w3v' ) 

Cveaie -bwo 
InWavs: one "to 

touni -tv»e nwmkev r nwnjjood ,_=• mWav-O 

o£ tovvett ansvievs l 

and anot^ev to J 

7ton^^- / 

Vnum badset(O) 



Display a -friendly 

h * t^h ■t'to d ^ ~ te*t— When you arc ready, dlidk on the buttons/*, height =■ 3) 



Be sure b> PACK your ~S> ! al !-.? a< *9 
widgets. 



Create two 
labels to bold 
each Counter / 
and donnedt the 
labels to the 
relevant Inters. 



labl =■ LabeKapp, te%tvariable — num^ood) 
lablpadk(side =• Me-PtO 



labZ =■ LabeKapp, te%tvariable =• num__bad) 



labZpadk(side =• right*) 



Create eadh o-f 
the buttons and 
donnedt the** to 
their relevant 
event handler. 




bl — Button(app, te%t — w Corred t/^> width =• 10 , Command =• ptay__dorredt__sound) 
bl padk(side =■ le-ft*, pad* =■ 10, pady =■ 10) 



bZ — Buttonfapp, te*t =• 'Wrong/**, 



width ==• 10 , Command — pldy__wrong_sound) 



Start 

tkinter s main 



event loop. 



bZ padk(side =• right*, pad* =■ 10, pady =■ 10) 



appmainloopO 
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test drive 




Tqst Drove 



With your newly amended code entered into IDLE, press F5 to see and 
hear the GUI in all its glory: 



Swee-fc.. . the -fully working 6jUI. 



TVN Game Shaw 



When you are ready, click on the buttons! 



16 



Correct ! 



Wrong! 




labels ave disftyn* 
running -totals With eatb 
mouse click (event)- 




T 

One -fmal decision; who ave you 
going -to take with you? 



254 Chapter 7 

Download at 



That's just perfect! The new 
version of the program works with 
my touchscreen and is so easy to use! 
I love it! Oh, and before I forget, 
here are your two front-row tickets 
for the Grand Final. See you then! 



^ There i*t is: -the host s 
winning TV smile! 




building a graphical user interface 




Your Programming Toolbox 

You've got Chapter 7 under your 
belt. Let's look back at what 
you've learned in this chapter: 
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8 gms and data 

# Data 



entry widgets + 




GUIs don’t just process events. They also handle data. 

Almost all GUI applications need to read user data, and choosing the right widgets can 
change your interface from data entry hell to user heaven. Widgets can accept plain 
text, or just present a menu of options. There are lots of different widgets out there, which 
means there are lots of choices, too. And, of course, making the right choice can make all 
the difference. It’s time to take your GUI program to the next level. 
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Head-Ex needs a new delivery system 

Head-Ex Deliveries is a small delivery company that’s looking to expand. 
They know that delivery companies rely on their computer systems, so they 
want to have a whole new system to book deliveries around the country 




The system needs to be simple to use, so they want to use a graphical user 
interface (GUI). They want to give you the job of creating the system and 
even have a sweetener to make it worth your while. 




guis and data 



They've already designed the interface 

Head-Ex has been thinking about expanding their business for a 
while and they already have a design for the interface to the new 
delivery system. This is what it needs to look like: 



Depot* 



Description; 



There are a Wh 
— • ot data-entr/ 
-fields- 




There a 
single WfcW 



So how will it work? It’s pretty simple, actually The user enters the 
details for a new delivery, including the description of the contents, 
the address it’s heading to, and the name of the Head-Ex depot it 
will be dispatched from. When the user clicks the Save button, the 
details are saved into a file called deliveries . txt. 



This is where the 
delivery details 
need to be saved- 



deliveries.txt 







What’s the difference between this GUI and the ones you created before? 
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text entry 



Read data from the GUI 



Think about the GUIs you’ve created so far. Those apps ran code in response 
to events generated by users clicking buttons. So what’s different here? Well, in 
addition to generating events, your users will also be creating data. 

You need to do two things: 



You need to create an interface with places to enter text. 

The Head-Ex design shows exactly what the interface will need to look 
like: 



You need some way of accessing that information. 

The data will need to be stored away in a file, so you need some way of 
asking the interface what text has been entered. That way, when 
someone clicks on the Save button, you’ll be able to write the data to 
the deliveries . txt file, like this: 



3 



Description; 



Address; 




3 




v^ow 'will need to APPEND this 
information to the -file whenever'''^ 
someone presses "Save ” 




Depot: 
Seattle, WA 
Description: 
Books 
Address: 

1 Main Street 

Anytown 

WA 
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The Ewtrv and Text widgets let you enter 
text data into yoor (rUl 

If you look at the interface design, you’ll see that there are two different types 
of text field you will need to handle: short text and longer, multi-line text 
fields. To deal with these two needs, Python’s tkinter library has two different 
widgets for each data-entry type: 



A TEXT FI£U> is jwt a 

VC bo* o» -the Street that you 
tan use to enter te*t- 



Entry widget: for entering single lines of text 

The Entry widget is what you’ll use for most of the text fields. You can 
create an Entry widget like this: 



my_small_field = Entry (app) 

Remember that you 
always need to imyort the 
tkinter library tirst- 



One single line ot text 

\L 



^///> 



i — - — . — — — 

starbuzzceo§gmail .com 






y 












Text widget: for longer, multi-line text 

Because not all text data fits on a single line, tkinter has the Text widget. 
Think of email messages, Wikipedia pages, and word processing documents. 
For large multi-line data, you need something other than Entry. You need 
Text: 



Multiple lines o-p -tex-fc 

X 



my_large_field = Text (app) 



you errtev lav-y pieces of 
textual data in We- 



Costello: I mean the fellow's name. Abbott: Who, 

■Costello: The gruy on first. Abbott: Who. Costel- 
lo: Tho first baseman, Abbott: Who- Costello: The! 
guy playing.,, Abbott: Who is on first! Costello: 
I'm asking YOU who's on first. Abbott: That's the. 
man Vs name. Costello: That's who h 3 name? Ahhatt: 

I Yes. Costello: well go ahead and tall me, Abbott: 
That's it. Costello: That's who? Abbott: Yes. 



The Entry and Text fields should be enough to create the Head- Ex 
interface. But it’s not enough to simply create the interface. You also need to 
control the data inside it. 



We V^* ed - 

^ J .Um suY 



Pytb' 



Y reiil *** 



, \S OX 



tirsb 
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control text fields 



Read and write data to text fields 

When someone enters text into an Entry widget, Python stores that text 
somewhere in memory as a string. If you want to read the string, simply call 
the widget’s get ( ) method: 



my_entry_f ield . get ( ) 
This will ve*tuvir> *the s'br’mj i Lt dvedr* 






ice cream 



— 






I 



But what if you want to change the contents of the widget, can you do that 
too? Yes, you can: add text to the widget using the insert ( ) method. It’s a 
little more involved than just reading the text, because you need to say where 
you want the text inserted: 



my_entry_f ield . insert ( 0 , "banana " ) 

ThCis the INPt* 

the insertion ?oint 



•,aj1 suJj 






banana ice cream 



’ — — — 



23^ 






O I 2 . 3 * 5 * 

. Entry -fields are indexed fro*. 0 




You need to specify the index of the insertion point. Indexes in Entry fields 
work just like indexes in strings: they begin at zero. So if you insert text at index 
0, the new text will appear at the front of all the text already in the field. In the 
same way, the delete ( ) method lets you remove text from the field. You 
might want to delete the entire contents of the field, so tkinter gives you a 
handy END symbol that lets you delete all the text like this: 

O is the index of the f irst 



my_entry_f ield . delete ( 0 , END) 

END is a special value 
that represents the last 
dharadter in the f ield- 



The final dharadter 
in the f ield is 
indexed by £NP~\ 








'fZtex//////// /// /a 


Yf 


'/ek/i 






s' 

A, 


fTT 












V 











All the text has ^one* 



The get ( ) , insert ( ) , and delete ( ) methods give you complete 
control over the contents of your Entry field. 

But what about Text fields? 
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Large Text fields are harder to handle 



So Text fields should work the same way, right? Well, actually, they don’t. 
The designers of tkinter figured people might want to access particular lines 
and columns in Text fields. This means that while Entry fields use a single 
number to index the contents of the field, Text fields use a string, in the form 

row. column: 



just use getO io 
9« the entire Contents. 

my_large_f ield . get ( ” 1 

This 'Mill return the entire 
contents of the t.eld- 



This means from the ROW- 
and COLmU-O, rihich is the 
tirst character in the tield 

< 

0", END) 

^This will return 
ALL of the text 
m 'the Text -field. 




T / hiS Usi character has index "I.O" 
Row I- 



s tel lor 1 the fellow’s name. Abbott: Who. 

tallo: Tha guy an first. Abbott.: Who. Cbsta-l- 
Ttier first baaeiRan. Abbott: Who. Costello: The 
ly playing. . . Abbott: Who ix on firat" Co? tn 1 1 a : 
asking YOU who's an first. Abbott: That's the 
irts name. Costello; That's who's naTne^ Abbott: 
Yds. Coatollo: Well go ahead and toll mo. Abbot t: 
That's it. Costello: That's who? Abbott: Yes. 



t 



CoW*** 0- 



Once you understand how Text indexes work, you’ll see that you can insert 
and delete text from them in a very similar way to Entry fields: 



my_large_f ield . delete ("l.O", END) 

This will clear -the field- 



my_large_f ield . insert (”1.0”, 



This 

the 



.serf the text at 
of the f ield- 



7 



"Some text") 



Now that you know how to create text fields and 
control the text they contain, you're ready to 
build the Head-Ex application. 




Be careful how 
you number 
rows and 
columns in 
Text() fields. 



Rows begin at 1, but columns 
begin at 0. 
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create the interface 



Code Magnets 

Complete the code to create the interface. Think carefully about the 
widgets you will need for each of the fields. 



from tkinter import * 

V . app = Tk() 

You don't heed , u k ()» adds 

brat k ^_ aPP ‘ tltle( ’ Head_EX ° ellVerieS ’ > VZT to the window- 

the labels, so ho Label (app, text = "Depot pack ( ) the ^ 

ih!!l f° dSSi . 9 " dep0t = EntrY (app) ^you'll want bo keep brack Calling >atkO" without 

Enables. depot . pack ( ) of the data entry -fields, SO means you leave it to tkinter 

assign them to variables. to dedide how best to lay 

thirds out oh the $U|. 




Button (app, text 



"Save", 



command = 




save_data) .pack() 



This means the button 
will tall the save_data() 
function when its tlitked- 





Label (app, text = "Description:") j| 


description I 









1 address = 1 




Label (app, text = "Address:") | 
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In addition to the GUI code, you need to write the function that 
will save the data from the GUI to the deliveries . txt file. 



The Save button on the interface is going to call a function called save_dat a ( ) . The function will 
append the data from the GUI to the end of the deliveries . txt file formatted like this: 




Then it will need to clear the fields on the form to make them ready for the next record to be entered. 
The function will have to appear in the program before the GUI code. Write the code for the function 
here: 

Pont Wojet it FIRST 
needs to save the data- 

TttFK it needs to tleav 

the -f ields- 
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app = Tk ( ) 

app . title (' Head-Ex Deliveries') 

Label (app, text = "Depot pack ( ) 
depot = Entry (app) 
depot . pack ( ) 

Label (app, text = "Description:") ||-pack() 



Create two | description = | | Entry (app) 

-fields: ohe is 

a* En-bry -field j description J.packO 
3^d the other 
is a Text -field- 



s» 



Address 
is a larger 
Te*t f ield- 



address = r Text (app) 



address I .pack() 



| Label (app, text = "Address : ") | .p ac k() 




IWt -forget to paek 
those widgets. 



Button(app, text = "Save", command = save_data) . pack ( ) 
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harpen your pencil 
Solution 



The Save button on the interface is going to call a function called 
save_dat a ( ) . The function will append the data from the GUI 
to the end of the deliveries . txt file formatted like this: 




Depot : 
Seattle, WA 
Description : 
Books 
Address : 

1 Main Street 
Any town 
WA 



Then it will need to clear the fields on the form ready for the next record to be entered. The function will 
have to appear in the program before the GUI code. You were to write the code for the function here: 

fe '?**'{* 3 the te*t to the 

little ^ 3 as did ^ v/e 'wv-ote the PCS 

-filcD =• 0pcir\( u ddivc\rics.*t%*t w ; VO 

v to «w the i 

-Pi I e D • Wri-te ( U D CSd\ri pti on : VO 
i 1 e ^ • >/ V"i*tc 0'%s\n W % description .^e*tO) 

^ (U| ° f.leD.y/tte( w Addvess: V) 

VC'tuVfiS “tnC *** y — 

to^ts O? a Tc*t £| e p. w iter%sV % addvesl^etr'l .0", m>» 

-field* 

[ depot-deleted, fcWW 

dcs .^Pi 0 ": dele k (0 !.^. D) 

address.deleteH.O", EKP) 

This means w ls*t row, 0*lb Column-* Remember 
t>at rows start at I and Columns -from O. 



Download at WoweBook.Com 



you are here ► 267 



test drive 




Tqst Drove 



The deliveries program is ready, so it is time for the demo. With the code 
entered into IDLE, press F5 to fire it up and you should see this: 



Hud-Ex E*vliv«ri*i- 



Dfljwt 

i&rtittlr, V/A 

LX-a i rutiur 

&Em 4 te 

/id diw;: 



$UI j s 

lookihj good. 



1 min Street 
hnjflnwn 




Sane 




JV 



You can enter data into each of the fields, even the multi- 
line address. When you click Save, the fields all get cleared. 
When you open up the deliveries.txt file, you see that 
the data you entered into the GUI has been saved. 



Depot : 
Seattle, WA 
Description : 
Books 
Address : 

1 Main Street 
Any town 



Congratulations! You've written your 
first GUI data-entry application. 
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BULLET 



POINTS 



■ Entry fields are used for single lines 
of text. 



Remove text with the delete ( ) 
method. 



■ Text fields are used to handle multi- 
line text. 

■ Read the contents of fields with the 
get ( ) method. 

■ Add text using the insert o method. 



Entry fields are indexed with a 
number starting atO. 

Text fields are indexed with a string, 
starting at "1.0". 



tJierejare no 

Dumb Questions 



n Is it possible to put more than one line of text into an 
Entry box widget? 



Yes, you probably could, but if you need to do this, you are 
much better off using a Text box, because they are designed to 
handle more than one line of text. 



o; I notice that we are calling the pack() method as part of 
the label creation code, whereas before we assigned the label 
to a variable then called pack() on the new variable. Which 
packing technique should I use and does it really matter? 

No, it does not really matter which technique you use to call 
pack ( ) . If it makes sense to pack your widgets as they are 
created, include the call to pack ( ) as part of the creation code. 
If it doesn't make sense, assign the widget to a variable and do 
your packing whenever you need to. If you look at other examples 
of tkinter code on the Web, you'll see that other programmers use 
both techniques. 



% Why can't we just assign a value to an E ntry box using 
the assignment operator (=)? Why do we have to use the 
insert!) method? 

The Entry box is a widget object, not a Python variable, 
so using the assignment operator does not make sense here. 
When working with objects, you need to use the application 
programming interface (API) provided by and included with the 
object, which in this case is the insert ( ) method. 

Q Why do the rows in a Text box start counting from one 
as opposed to zero (like everything else in Python)? 

Beats the hell out of us. No idea. 

Q So, just to be clear, Who is on first? 

No. Who is on second. Python is on first. 
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the other Cambridge 



One of the Head-Ex deliveries went astray 

For the first few days, the system worked great. Deliveries were correctly 
booked and goods were shipped. But then, something odd happened at the 
British delivery depot. 



I'm terribly sorry, old chap, 
but I think these boxes 
were meant for the other 
Cambridge. Cup of tea? 



’ 4 



~4 t — „ 



I ? 



i 



_ 



One of the deliveries went seriously astray. A consignment of college 
football jerseys was sent to Cambridge in England , instead of the Cambridge 
in Massachusetts. But the system is still working fine, isn’t it? So what could 
possibly have gone wrong? 

There's no time for tea. Let's get to the bottom of this. 

Bu-fc rt was lovely 

to be asked... 
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Users can enter anything in the fields 

The system is doing exactly what it was designed to do: it lets people enter 
the details for depots, descriptions, and addresses. The trouble is, even though 
there are only a few depots, the Entry text fields lets the user type pretty 
much anything. There are no controls on what gets entered into the GUI. 




This is AMBIGUOUS. H 
is no - t -to-blly clear which 
Cambridge is meant 



It wasn’t obvious whether the delivery was intended for the Head- Ex depot 
in Cambridge, MA, or the Head-Ex depot in Cambridge, England. You need 
some way to prevent users from entering ambiguous data in the depot field. 







Think about the GUIs you’ve used in the past. How could you 
restrict the values that someone could enter into a GUI? 
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radio buttons 



Radio buttons force users to choose a 
valid depot 

Text fields aren’t the only data-entry game in town. If you look at any 
GUI program, you will find a whole host of different widgets being used: 
sliders, buttons, check boxes. Why are there so many different types of 
widget? Are they just there to make the interface more interesting to use? 

The reason there are so many widgets is to allow the programmer to 
efficiently manage and control the kind of data that people can enter. 




If you want to allow a small number of values for a field, you can 
use the radio button widget. A radio button works just like the AM/FM 
selection buttons on your radio: press AM and the FM button pops up. 
Press FM and the reverse happens. 

Radio buttons in a GUI program work in the same way: if you select 
one of the buttons, the other buttons are automatically deselected. That 
way, you can choose only one from a small group of options. 



Radio WtW 



cepo-t: 

mft 

O Cambridge, uwi 
O S»ea-tt\e, uoft 




Click F/Vl a »d -the AM butU. P o P s up . 



/// ' ' 





i 



Descnp-tioiv 

— ~ -J 



Address: 

H3 

Save 

— J 



So if you replace the depot Entry field in the Head-Ex 
program with a set of radio buttons, you prevent users from 
entering ambiguous depot names. That way, they will be able 
to choose one, and only one , depot. 
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Creating radio buttons in tkinter 

You need to create three radio buttons in the interface, one for each of the 
depots. This is how you might do that in tkinter: 




J his ^ the text 
that will appear 

* e *f ^e radio 

butfcoh. 



You need to remove the depot Entry widget and replace it with three 
Radiobutton widgets, one for each of the valid depots. The text given to 
each widget will be the text that appears alongside the radio button in the 
interface. 

What about reading which radio button has been selected? For now, you just 
need to create a prototype of the interface, so there’s no need to change any 
of the code that saves records. That’s something we can deal with later. 

Let's demo the new interface to the guys at Head-Ex. 
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test drive 




Tost Drove 



It’s time for the demo of the new version of the interface. When the guys 
from Head- Ex arrive, you fire up the new program in IDLE: 




There’s clearly something wrong with the prototype. There is only 
supposed to be one radio button selected at any one time, and yet the 
program shows all of the radio buttons selected together. 

What happened? You need to look in a little more 
detail at how radio buttons actually work. 
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The radio buttons should work together 

When you modified the code, you added the three radio buttons like this: 

Radiobutton (app, text = "Cambridge, MA" ) .pack ( ) 
Radiobutton (app, text = "Cambridge, UK").pack() 
Radiobutton (app, text = "Seattle, WA").pack() 

That code added three new radio buttons to the interface, but it created 
them as three independent widgets. This means that each of the radio buttons is 
working separately, with no knowledge of the other two. 





O 



o 



0 Cambridge, MA 
0 (£5 Cambridge, UK 




Seattle, WA 



But the whole point of radio buttons is that they work together. 
When you select one radio button, you expect all of the other radio 
buttons to be deselected, just like the buttons on the radio. 

GUI programs often need to synchronize different widgets 
together. You do something to one widget, which results in 
something else happening to another widget. 

So how might you get your radio buttons to 
cooperate? 



VVhen the AM button 

selected, ihe RM button 
should be deselected- 

\jL ^ 









Think about the way you want radio buttons to work. Is there something 
that they all need to share? What is it? 
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The radio buttons can share a model 



The text fields you originally created each stored a single data item. For every 
widget on the screen, there was a single piece of data. But that’s not true 
for your radio buttons. The three radio buttons will be used by the user to 
record just one thing: the depot that a delivery is sent to. The three radio 
buttons needs to share a single piece of data. And that piece of data is called the 
model. 



O 

0 




This is the model 

W.dde* av-ay in Y ou ’ f 

torn? uter's memory- ^ 



Q) Cambridge, MA 




O© 



Click me, so I can 
update the model... 




Cambridge, UK 



I 

0 1 

© Seattle , WA 



So if the Seattle radio button is selected, it will update the model with 
a new value. 

You haven’t set values on the radio buttons yet; you’ve only set text 
descriptions. You could set the values to be whatever you want, but it is 
simplest to set them to the same thing used as the description of the field: 



"The text is -the desdrip-fcioK 
that appears ok -the sdreeK. >. 

RadioButton (app, text 



vT 



This VAL-Wfc is the one that 
Will he used in the model- 



"Cambridge, MA", value = "Cambridge, 

You tan make the te*t different 
tom the value, but let's leave 



MA") 



So what happens after the model is updated? 
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The system tells the other widgets when 
the model changes 



The tkinter library code will keep a track of which widgets are using which 
models and, whenever a model changes, tkinter will let the widgets know 
about it. So if we select the Seattle , WA radio button, it will update 
the model, and the other radio buttons that share the model will deselect 
themselves. 




Seattle, WA 




UK 




There’s a special name for the way this code works: 



\ 



/ 









/ 



o 

o 

o 




The model is the data stored. 



View Controller 



The view is just a fancy name for the widget. 



And the controller is the code in tkinter that lets all of the views know 
when the model has changed. 



So much for the MVC theory. Time to fix the code. 
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So how do you use models in tkinter? 

Imagine you wanted to add delivery options to the program. You could use 

radio buttons and do something like this: EXPLICITLY <yve 

eatb button a VALUE- 

Radiobutton (app, text = "First Class ", value = "First Class") .pack() 

Radiobutton (app, text = "Next Business Day" , value = "Next Business Day"). pack () 



You then need to create a model for the radio buttons to share. In tkinter, 
models are called control variables, and control variables that store text 

are called St ringVars: . , Lx/ r 

h Stv-MVav is just like the InWar Worn 

isr — ' Chapter 1 , e*£eyt that it holds a string value- 

service = StringVar ( ) ^ ^ ^ ^ ^ ^ va|ue 

service, set (None)^ w |\Ue" meaM value." 

Radiobutton (app, text = "First Class", value = "First Class’ 



variable = service) .pack ( ) 

Radiobutton (app, text = "Next Business Day", value = "Next Business Day", 
variable = service) .pack ( ) 



This code will now give us a pair of buttons that work together. If you 
select one, the other will automatically become deselected: 



Ckk to, SECOND ofW -©First Class 

nm kt ,teel “ W "©Next Business Day 



And if you ever need to read or change the model value in the code, you just 
need to call the StringVar's get ( ) or set ( ) methods: 



»> print (service . get () ) 
"Next Business Day" 



This returns tbe Current 
value o£ tbe model- 




tjH First Class 
'Q Next Business Day 
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Paa] Puzz]e 

This is the section of the program that 
creates the depot radio buttons. See 
if you can complete it using the 
fragments of code from the pool. 
Be warned: you might not need 
all of the pieces... 



Label (app, text = "Depot: ") .pack () 



depot . set (None) 

Radiobutton (app, , , ) . pack() 

Radiobutton (app, , , ).pack() 

Radiobutton (app, , , ) . pack() 



Note: each thing from 





What piece of code would you use to make sure all of the radio 
buttons are cleared offer the record is saved? 
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Pool Puzz]e §®]ufion 

This is the section of the program that 
creates the depot radio buttons. 

You were asked to see if you could 
complete it using the fragments of 
code from the pool. Not all of the 
pieces were needed. 



Label (app, text = "Depot : " ) . pack ( ) 

depot = StringVar ( ) 

depot . set (None) 



Radiobutton (app. 


variable = depot. 


text = "Cambridge, MA" 


, value = "Cambridge, 


MA") 


. pack ( ) 


Radiobutton (app. 


variable = depot. 


text = "Cambridge, UK" 


, value = "Cambridge, 


UK") 


. pack ( ) 


Radiobutton (app. 


variable = depot. 


text = "Seattle, WA", 


value = "Seattle, WA" ; 


) .pack ( ) 



Note: each thing from 





Because none o£ the v-adio — 
buttons have Ibis value, none 
o-f "them will be seletted- 



What piece of code would you use to make sure all of the radio 
buttons are cleared after the record is saved? 

defotsct(Kor\c) 
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Tost DriVq 



Now it’s time for another demo of your program. When you first fire up the 
program, you see that there are initially no depots selected. 




That’s good. Now what happens if you select the first option, then change to 
the third? 



MBad-Ex DBlivariBE 



ucpot: 
Cambridge. MA 
Cambridge UK 
Spftftte, WA 




H Bad -Ex DaltVtiNtit 



Depot; 

Cambridge. MA 
Cambridge. UK 
S 4 ddtlle r WA 
Description- 

Add i *ih-h : 



|-f you seled-t "Seattle, 
VVA”j yw automatically 
deselect "Camkv-id^e, 

/WA". 




If you make a selection, the other radio buttons automatically deselect 
themselves, which is exactly what you need. 



The radio buttons are working correctly. 



Down 




you are here 
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many more depots 



Head-Ex's business is expanding 

With the new systems in place, business is better than ever at Head- Ex. They 
have new trucks, more employees, and an increasing number of offices. 




But with this success comes a new problem... 
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There are too many depots on the (rUI 

The coders at Head-Ex have been amending your program to add new 
depots as they were opened. But there’s a problem. Now there are so many 
depots that they can’t all fit on the screen. 




Something needs to be done to the GUI. But what? 










What kind of widget would you use instead of a radio button to fix this? 
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multiple options 



An OptionMenu lets you have as many 
options as needed 

An OptionMenu or drop-down listbox is a widget that lets you restrict the 
number of options a user can choose, just like a group of radio buttons. But 
it has a couple of important differences. 

First, it takes up a lot less space than a functionally equivalent group of radio 
buttons, about the same amount of space as an Entry text field. Second — 
and this is the really important characteristic — when you click it, an option 
menu can display a large list of options. 



Depo-b 

Cam bridge MA 



|Ga 



Cambridge, UK 
jSeatiUs, WA 
New York, NY 
Dallas, TX 
'Boston,, MA 
jftciTTie, Italy 
Male, Maldives 
|Luxor h Egypt 
IWiod&s* Greece 
Edinburgh^ Scotland 



B 



=3 



s^ave 



rhe use*- Could 
selec{ a depot (yon, 
** option menu. 



If the Head- Ex coders use an option menu, they will be able to increase 
the number of depots available, but they won’t have to increase the size or 
complexity of their GUI. 

So what needs to be changed in the code if you want to swap the radio 
buttons for an option menu? 

It's not what changes, but what stays the same. 
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The model stays the same 

Think for a moment about the model you are using with the radio buttons. 
It represents the name of the chosen depot, which you want to keep for the 
option menu. If the model stays the same, then your code, which currently 
looks like this: 



depot = StringVar ( ) 
depot . set (None) 

Radiobutton (app, variable = depot, text 
Radiobutton (app, variable = depot, text 
Radiobutton (app, variable = depot, text 



"Cambridge, MA" , value 
"Cambridge, UK", value 
"Seattle, WA", value 



"Cambridge, MA") . pack() 
"Cambridge, UK").pack() 
"Seattle, WA").pack() 



can be replaced with code like this: 
depot = StringVar () 
depot . set (None) 

OptionMenu (app, depot, "Cambridge, MA", "Cambridge, UK", "Seattle, WA").pack() 



t 

The setond 

he the model a»d it does»>t 
need the "variable - bit 



k 

A list o( all the options that 
appear in the widget 






■rhis is the same 
►»*odel as betore. 




■ — ^ Cam bridge, MA 
^flC&rcibriclgd, UK” 
/ |Seaule. WA 
w* New York, NY 
‘Dallas, TX 
Boston, MA 
;RoT7ie, Italy 
Male, Maldives 



B 






Put wait... you don't have to list aH the values like that 

It looks like a lot of work to put all of the options in the actual function call to 
OptionMenu ( ) , doesn’t it? After all, there’s a large list of depots. 

Thankfully, Python comes to the rescue. If you have the options already 
stored in a list: 



|Luxor, Egypt 
Rhodes, Greece 
Edinburgh, Scotland 



depots = ["Cambridge, MA", "Cambridge, UK", "Seattle, WA" ] 



you can pass the entire list instead of separate values like this: 



I, f 



OptionMenu (app, depot, * depots ). pack ( ) 



Now let's put the pieces together. 
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M 



£oh£ ExeRciSe 



This is a version of the program that uses radio buttons. 

You are going to update this program so that it uses an option menu. But the options need to be read 
from a text file. 



from tkinter import * 
def save_data() : 

fileD = open ( "deliveries . txt ", "a") 

f ileD . write ( "Depot : \n" ) 

fileD . write ( "%s\n" % depot . get () ) 

fileD . write ( "Description : \n" ) 

fileD . write ( ’ 

fileD . write ( 1 

fileD . write ( 1 

depot . set (Noi 

description . c 

description . c 

address . delet 

app = Tk ( ) 

app . tit le (' Head-Ex Deliveries') 

Label (app, text = "Depot :"). pack ( ) 
depot = StringVar() 

Eons^) — 

n(app, variable = depot, text = "Cambridge, MA", 

n(app, variable = depot, text = "Cambridge, UK", 

n(app, variable = depot, text = "Seattle, WA", 

Label (app, text = "Description :"). pack ( ) 
description = Entry (app) 
description . pack ( ) 

Label (app, text = "Address :"). pack ( ) 
address = Text (app) 
address . pack ( ) 

Button(app, text = "Save", command = save_data) . pack ( ) 
app .mainloop ( ) 
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First, you need to create a function called read_depots o thatwill read the lines in a text file and return them to 
your code as a list. 

Hint: When you read a line from the file, it might have a newline character at the end. The rstrip ( ) string method 
will remove it for you. 




Then, you need to replace this section of the code with code that generates an option menu using the data from the 
© read_depots ( ) function you just created. It should use a file called depots . txt. Write the code here: 



Download at WoweBook.Com 



you are here ► 287 



options added 



is a version of the program that uses radio buttons. 

You needed to update this program so that it used an option menu. But the options 
were to be read from a text file. 

from tkinter import * 






£°h£ Exercise 
Soiuti 



This 



def save_data(): 

fileD = open ("deliveries .txt ", "a") 

f ileD . write ( "Depot : \n" ) 
fileD . write ( "%s\n" % depot . get () ) 
fileD . write ( "Description : \n" ) 




app . tit le (' Head-Ex Deliveries') 

Label (app, text = "Depot :"). pack ( ) 
depot = StringVar() 
depot . setj 

Radiobutton (app, variable = depot, text = "Cambridge, MA", value = "Cambridge, 
pack ( ) 

Radiobutton (app, variable = depot, text = "Cambridge, UK", value = "Cambridge, UK") . 
pack ( ) 

Radiobutton (app, variable = depot, text = "Seattle, WA", value = "Seattle, WA"). 
Dack ( ) 

Label (app, text = "Descript ion :"). pack ( ) 
description = Entry (app) 
description . pack ( ) 

Label (app, text = "Address :"). pack ( ) 
address = Text (app) 
address . pack ( ) 

Button(app, text = "Save", command = save_data) . pack ( ) 
app .mainloop ( ) 
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O 



First, you needed to create a function called read_depots o to read the lines in a text file and return them as a list. 



Open the file- 

Read from the tile one 
line at a time. 



def read_depots (file) : Start with an 

= a 



=- ofCh^ilc) 
(or line in depots^; 



Affend a striked Copy of depots.append(linerstripO) 

the line to the array. 1 Ir r 



return depots 



Return the list to 
the calling tode- 



Then, you needed to replace this section of the code with code that generated an option menu using the data returned 
O by the read_depots ( ) function. It needed to use a file called depots . txt. You were to write the code here: 



Call the -function, passing in the 

name of the f ile to read the data 

^' ron '- \ options — read_depots("depots t*fO 

Use the data to build the ^ .^ o P' tio "' s ' ) :.P adk0 

option menu- 
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test drive 




Tsst DriVq 



Before you run your program, be sure to create the depots . txt file. When 
you start up the program in IDLE, the interface is a lot more compact and 
even easier to use: 



A n \tt and neat list o£ 
depot options 




The system is working really well now. And, due to the depots being stored in 
a file, Head-Ex can change the list of depots in the file without having to amend 
the code in any way. 



Your GUI program builds the list of depots dynamically 
and on-demand, which makes it very flexible indeed. 
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Things are going great at Head-Ex 

The GUI system is easy to use, and by restricting the depots with an option 
menu, the quality of the entered data is spot on. This means the Head-Ex 
delivery service is more reliable, the number of customers is increasing, and 
the business is growing bigger — worldwide. 






Chetkoutrtea d-fc*’* 

evev-e*\>3«d m 3 *' ee ^ 

Using tkinteCs data models, you used the power of 
model-view-controller to build a GUI data-entry system 
that really rocks. 
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programming toolbox 




Your Programming Toolbox 

You've got Chapter 8 under your belt. 
Let's look back at what you've learned 
in this chapter: 
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X Get the message ?+ 




Sometimes things just go wrong. You just need to handle it. 

There will always be things beyond your control. Networks will fail. Files will disappear. 
Smart coders learn how to deal with those kinds of errors and make their programs 
recover gracefully. The best software keeps the user informed about the bad things that 
happen and what should be done to recover. By learning how to use exceptions and 
message boxes, you can take your software to the next level of reliability and quality. 
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the cheese stands alone 



What's that smell? 

Just when it looked like things were going so well, there was 
a problem in the Head-Ex storeroom. 




A trainee was recording the consignment of cheese when 
there was a problem that prevented the program from 
recording the delivery. That meant the cheese was never 
assigned to a delivery truck. So the cheese never left the 
storeroom and it just sat there for a very long time. And that 
meant — well, you can just imagine... 



To prevent the same thing happening again, 
you need to find what caused the problem. 
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Someone changed the file permissions 



It turns out the whole thing was caused when someone from Technical Support 
decided to change the permissions on the deliveries . txt file, making it 
read-only. When the system tried to write deliveries into the file, it failed. But 
what’s worse, it failed silently: 



Because no ev-v-ov- 
message appeared \n 
•the £jU|, ihe -trainee 
-thinks everything is 







w deliveries.-t%-t w 
was made read- 
only- 



Haad-Ex Dalivertae 



Depot: 

E Jin bur qli, SeuUdrd 



UMcription- 



Awnrterl 

Addiw^b. 



cheese Hleasc! 
1 TEfi Pn 
EdijiLiuryli 
Scotland 



deliveries.txt 



The error in -the 
Python Shell was ^ 
nol noticed by -the 
-trainee- 



riip rriit r.Kpii m 



i'yt ftem A . 1 . 1 £ 
|QCC 4.3.3J urn 1 
Type " copyright " 



»> 

»> 



»> 

"Rii'hfjiil J cm i in TSl i 
TraccbapJt ijmoat 
F ili-r m /umf /lm:. 

return Belt, 
File: "/fccinwi/tui 
tile — open 4 ,IH i 3 
TOF1 r r 1 1 r : f Fir r m 1 H 






ffft 1 1-” 1 ■ ■ • i-tT : ' rlt r l i vt*r i'Hn . 



L n a Oil r>| 



When you were writing programs that ran in the Python Shell, 
you could always tell when it failed: a huge, ugly error message 
appeared. Why not with GUIs? Don’t they do the same? 

They do, but the trouble is that the message appears in the Shell 
and your user is busy looking at the nice GUI, so the ugly error 
can often be missed. 



When using a GUI, how do you spot errors? 
Once spotted, what happens then? 



Note: To reproduce this error on your PC, 
you need to make your deliveries . txt 
file read-only. How you do this depends 
upon your operating system. If you are 
unsure how to make a file read-only, check 
the Web for more advice (or ask a friendly 
local guru). On most systems, it involves 
editing the properties of the file. 
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When it couldn't write to the file, 
the program threw an exception 

What happens when an error occurs? Some errors are really bad : they cause 
the program to crash. Other, less serious errors are known as recoverable : the 
program can keep running, even though something went wrong. You can spot 
these situations in your code, because most programming technologies throw 
an exception when they occur. 

Imagine a line of code that has a problem, such as the line that was trying 
to write to the deliveries . txt file. Python will spot that the append 
operation failed and, instead of running the rest of the code that follows, 
Python abandons ship and skips out of the code completely. That’s what 
throwing an exception means: the program doesn’t crash , but it abandons what 




But why skip past the rest of the code? Why not keep on running? Generally, 
that would be a bad idea. Once a line of code has gone bad , there’s no way of 
knowing if it makes sense to keep running the code that follows. For example, 
if the Head-Ex code can’t open the deliveries file to append to it, it makes no 
sense to continue trying to write data to the unopened file! 

In order to recover, you need to start running your code 
from somewhere else. 
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Catch the exception 

Python spots when an exception is thrown , and you can write some code to 
run when the exception occurs. This is called catching the exception. The code 
that you run when there’s an error resulting in the thrown exception is called 

an exception handler. 



X J f 




Creating exception handlers can really make life easy for your users. Instead 
of a flaky program that crashes or fails silently the first time something weird 
happens, you can write programs that gracefully recover from errors. Exception 
handlers tidy up when something goes wrong and can even let your user 
know that something strange happened. 

That’s what you need here: an exception handler that tells the user when 
there’s a problem writing a delivery to the file. 

How are exception handlers written in Python? 



A piece ol code 
that runs when 
an exception is 
thrown is called an 
exception handler. 
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Watch for exceptions with try/except 

In order to recover from an error as it happens, you need to indicate the code 
that might throw an exception. In Python, you do this with try and except. 

All you need to do is take the piece of potentially troublesome code and add 
the try and except labels: 



Put the exception 
handler labels around all 
o-f this tode- 



I ' P an exception is thrown 
ANY WHERE in this 
section, the Computer will 
jump to the £ode HERE. 



def save_data() : 

try : 

fileD = open ( "deliveries . txt " , "a”) 

f ileD . write ( "Depot : \n" ) 
fileD . write ( "%s\n" % depot . get () ) 
fileD . write ( "Description : \n" ) 
fileD . write ( "%s\n" % description . get () ) 
fileD . write ( "Address : \n" ) 

fileD . write ( "%s\n" % address . get (" 1 . 0 " , END)) 
depot . set ( " " ) 

descript ion . delete ( 0 , END) 
descript ion . delete ( 0 , END) 
address . delete (" 1 . 0 " , END) 



Noic-. -this code 
' s '^dented 

Uh der the "try" 

statement- 

j 




except Exception as ex: 



This is where the EXCEPTION 
HANDLER dode 3oes. 




• Inside the handler, the exception is 
assigned to a variable dalled w ex w . 



If an exception is thrown between the try and except labels, the code 
that follows the except label runs. The code that threw the exception 
is abandoned. If no exception occurs, the code runs normally and the 
code that comes after the except label is ignored. 

Notice that the try/ except labels are wrapped around all of the 
function’s code. If there’s a problem opening the deliveries.txt 
file, you don’t ever want to try writing to it. So, when trouble strikes, 
you should adandon ship and skip to the code that tries to recover from 
the error. 



The code that then runs is the exception handler. 
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i 1 

i 



Exception Magnets 

Assemble the code to handle an exception in the save_data ( ) 
function. The exception handler needs to display the details of the 
exception in the title bar of the window. Note: remember to indent 
the code in the exception handler, in addition to the code in the 
try block. 



fileD = open ( "deliveries . txt " , "a") 

f ileD . write ( "Depot : \n" ) 

fileD .write ( "%s\n n % depot . get () ) 

fileD . write ( "Description : \n" ) 

fileD .write ( "%s\n" % descript ion . get () ) 

fileD . write ( "Address : \n" ) 

fileD .write ( "%s\n" % address . get (" 1 . 0 " , END)) 
depot . set ( " " ) 

description . delete ( 0 , END) 
description . delete ( 0 , END) 
address . delete (" 1 . 0 " , END) 
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Exception Magnets Solution 

You were asked to assemble the code to handle an exception in the 
save_data ( ) function. The exception handler needs to display 
the details of the exception in the title bar of the window. You 
needed to remember to indent the code in the exception handler, in 
addition to the code in the try block. 




fileD = open ( "deliveries . txt " , "a") 

f ileD . write ( "Depot : \n" ) 

fileD .write ( "%s\n" % depot . get () ) 

fileD . write ( "Description : \n" ) 

fileD .write ( "%s\n" % descript ion . get () ) 

fileD . write ( "Address : \n" ) 

f ileD . write (" %s\n" % address . get (" 1 . 0 " , END)) 
depot . set ( " " ) 

description . delete ( 0, END) 
description . delete ( 0, END) 




The exception handler ean have 
several lines as long as -they are 
all mdew-ted m -the same way. 
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Tsst DriVs 



Let’s see if the code works. Make sure the deliveries . txt file is read- 
only. Then run the new version of the program in IDLE and try to record a 
delivery by clicking on the Save button. 

Cltekina "Save" 

causes -tbe ^ 

-title bar *to 



-tbe error. 




deliveries.txt 




Sure enough, when you try to save the delivery details, the program catches the 
exception and the exception handler displays the error message in the window 
title. 



Wonder what the people at Head-Ex will think of this? 



Not* ™ake sure 
deliveries.*t**t is 
se*t *to read— only. 
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There's an issue with the exception handler 

You do a quick demo for the folks at Head-Ex and, even though the program 
works, it’s not quite what they need. 




The error message is more visible than when it was appearing in the Python 
Shell , but it isn’t a whole lot more visible. Sure, you’ve proved that you can 
spot when an error happens and then run an exception handler in order to 
do something about the error. But you really need to do something that will 
interrupt the user and highlight the situation. You need something that will 
force the user to acknowledge the error before he continues doing something 
else. 



A GUI message box might do the trick. 
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A message box demands attention 

Most of the time, GUI programs put the user in charge. If the user chooses 
to click a button or edit a field, the computer lets them do just that in 
whatever order and at whatever time the user chooses. But sometimes, GUI 
programs need to stop the user and ask her a question, getting her to confirm 
or acknowledge something. That’s where message boxes come in. 

A message box is something that requires a response, which is why it’s 
sometimes called a dialog box. 

The simplest message box displays a message with a single OK button: 




This i tor\ shows 
\{!s d 



^This is the 



The user must dlidk the "0^" button 
to dontinue, 'mdidatmj that she 



adknoNwIed^es the message 



message 



A message box always displays the message in a separate window, typically 
in front of your main GUI window. And it won’t go away until you click 
it, dismissing it. That’s why message boxes are the most commonly used way 
of displaying errors. The user has to read and respond to the error before 
continuing. 

You should be sparing in how often you display message boxes, because if 
users see too many of them, they are likely to click them without reading the 
message. But, when used carefully, they keep your user informed and alert. 
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Creating message boxes in Python 

All of the message box code is contained within a tkinter module called 
messagebox, so the first thing to do is import the module: 

import tkinter . messagebox 



Then, you’re good to go. Within the messagebox module, there’s a whole 
bunch of different dialogs to choose from. But all of them fall into two main 
categories. 



Message boxes that say stuff 

To display a simple message on the screen, you might display a message box 

The don-ien-fcs o( -the r*essa<\e. . 

t 

tkinter . messagebox . showinfo ( "Delivery ", "The cupcakes have arrived in Istanbul") 

The *ti*tle o-f -the message 



The i£oh m the window shows 
that this is just -for mtoV'^atio 

You need to t\\ck the 



f O SBNoeUver^ f B )L @ L)[ S3 J 


1 /J"\ i he aupdaKes have < 

j Istanbul 

^ L 

L ._ . 


3t r ived in 



Message boxes that ask stuff 

If you need a message box that asks the users a question, you will need to 
check the return value to see what they chose: 



response = tkinter . messagebox . askyesnocancel ( "Gift ? ", "Gift wrap the package?") 



if 

A value is assigned to "response” a-fter 
the user dlieks one ot the buttons. 

When tkinter gets to this line, it will wait for the user to 
answer the question and then assign True (yes), False 
(no), or None (cancel) to the response variable. 

Let's see what other message boxes are 
available. 



0 












S3 



<J) uutap the pacKao.e? 
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+ • ^ 

+ 4 2 + 

WMC 

These are the message boxes available in tkinter. Think carefully about 
each of the following examples. We know which we’d use at Head First 
Labs. Which type of box on the left would you choose for each of the 
messages on the right? Connect the messages to the boxes with lines. 



showinf o 


“OK to fire boosters?” 



showwarning 


“Your tartan clogs have arrived.” 



showerror 


“Seriously I think he’s just ignoring the phone.” 



askquestion 


“Danger, Will Robinson!” 



askokcancel 


“Do you want fries with that?” 



askyesnocancel 


“Dude, the printer’s busted.” 



askretry cancel 


“So, you want Nutella on your bacon and jelly sandwich?” 
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* 



These are the message boxes available in tkinter. You were to think 
carefully about each of the following examples, then indicate which 
type of box on the left you would choose for each of the messages on 
the right. You were to connect the messages to the boxes with lines. 

Are you REALLY sure you want to 
Continue and do this thing? It's your 
last chance to change your mind- 

:c OK to fire boosters?” 

This is pure in-Porimation. Nothing 
to worry about- Except the risk o-P 
clashing with you r velvet pixie hood 

‘Your tartan clogs have arrived.” 



It didn't work last time, but it you like, you can try again. 

T 

‘Seriously, I think he’s just ignoring the phone.” 




0&, so -there's nothing actually 

‘Danger, Will Robinson!” broken YBT, but BE CAREFUL 

You are ^oi ng to Continue, but 
do you want this extra option? 

‘Do you want fries with that?” 






Stu-Pf's broken. You need to know. 



‘Dude, the printer’s busted? 






Do you want this additional option, or would 
you like to torget about the whole thing? 



‘So, you want Nutella on your bacon and jelly sandwich?” 



Did your answers match ours? They might not- Selecting which type ot message box • 
depends a lot upon the particular program you're writing and how serious you think a 



to use 
decision is. 
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def save_data() : 
try : 

fileD = open ("deliveries .txt", "a") 

f ileD . write ( "Depot :\n") 

fileD . write ( "%s\n" % depot . get () ) 

fileD . write ( "Description : \n" ) 

f ileD . write (" %s\n" % description . get () ) 

fileD . write ( "Address : \n" ) 

f ileD . write (" %s\n" % address . get (" 1 . 0 " , END)) 
depot . set ( " " ) 

description . delete (0, END) 
description . delete (0, END) 
address . delete (" 1 . 0 " , END) 
except Exception as ex: 
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get the message 




The folks at Head-Ex want your program to display this message 
box if there's a problem saving a record to the 

deliveries . txt file: 




Complete the missing lines in this section of your program to create the message box. 

Hint: You need to include a newline in the message box text. 

from tkinter import * 

*tk’m*tc\r.mcssa^cbox. 

Remember to 
import the 

netessary module- def save_data(): 
try : 

f ileD=open ( "deliveries . txt " , "a" ) 

f ileD . write ( "Depot \n" ) 

fileD . write ( "%s\n" % depot . get () ) 

f ileD . write ( "Description\n" ) 

fileD . write ( "%s\n" % description . get () ) 

fileD . write ( "Address\n" ) 

f ileD . write (" %s\n" % address . get (" 1 . 0 " , END)) 
depot .set ( " " ) 

description . delete (0, END) 
description . delete (0, END) 
address . delete (" 1 . 0 " , END) 
except Exception as ex: 

'tk'm*tcv*.mcssacicbo%.sboy/c\r\ro\r( u Ev\ro\r^ , > U Ca^*t v/v-ite *b o tbc -PileX* %s” % 

. ° fs S 

Vow should use the showerrorO tmetioh so that 
the dialog box gets the torrent error i tor,. 
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Tqst DriVq 



Now what happens if you try to save a record when the deliveries . txt 
file is read-only? 




Great! The exception handler displays an error message 
with an icon that really alerts the user to the problem. 
Let's check back with Head-Ex to see if they like it. 
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durian delivered 




Great work! 



That's exactly what we need. And not a 
moment too soon. We just had a delivery 
of durian, the world's stinkiest fruit. 
There's no way we want to leave THAT 
delivery too long in the stock room! 



lit mix 



The error message box was exactly what 
Head- Ex needed. 

By catching exceptions and displaying 
important information in message boxes, 
you can greatly improve the experience of 
your users when things go wrong. 
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exceptions and message boxes 




Your Programming Toolbox 

You've got Chapter 8.5 under 
your belt. Let's look back at what 
you've learned in this chapter: 



PyOOff ^ 0< 






* c ' r ' f0 * S wS tead- 
itoro* CT'-tc? MW ' here’s 3» eiU "' 



■ ,a\\ed " ta ^ Ww?> 

‘ * ,w "' 

* C °J e .rftvfe" 

U L\k\ w^CSSdV 0 



* 6j\Al «* ssd V 
c^est' 0 ^- 

► \)OT<-CS 




f > y ih °» Tcou 



* uw 

vt vt ■« y* 



^ You >,/ , 

w«t. 

'*»*,'**» < "~*“^ty 

•*. t 1 ■*■■ *»*«*, 

/es - » ^T” * h' , 

* * k ** k mes ^ ’*' v “ 6< 

* / w . " Fjl * it U' 

C **d. p °“"«*«> 

the hes P onse was 



yoi/ are here ► 
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9 graphical interface elements 



* Selecting the + 

* right tool + 




Yikes! I was sure the 
salesman said the box 
contained an Ultimate 
GUI Toolkit™. 



It's easy to make your programs more effective for your users. 

And when it comes to GUI applications, there’s a world of difference between a working 
interface and one that’s both useful and effective. Selecting the right tool for the right job 
is a skill that comes with experience, and the best way to get that experience is to use 
the tools available to you. In this chapter, you’ll continue to expand your GUI application 
building skills. There’s a bunch of truly useful widgets waiting to be experienced. So, turn 
the page and let’s get going. 
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this is a new chapter 



dj goes digital 



Time to mix it up 

Your best friend is an ultra hip DJ with a problem: his vinyl 
collection is now so large that he can’t carry it all around 
from club to club anymore. He’s decided to digitize his entire 
collection, put it on his laptop, and mix his sounds from there. 
His problem is that commercial mixing software costs a fortune 
and he doesn’t like any of the free alternatives. He has his 
own ideas for the mixing software he wants. 




What with spending all his time mixing music, he’s never q 

learned how to program his computer... and that’s where you 
come in. If you help him to write the software he needs, he 
promises to showcase your work at the upcoming World Music 
Mixing Expo. 

Let’s build the mixing software bit-by-bit based on the DJ’s 
requirements. 



All o£ tW.s has -to <y>- 
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Code Magnets 

A couple of buttons on a GUI ought to do it. Here's the code to a 
small tkinter program that starts and stops a sound file. Rearrange 
the code magnets to make the program: 



from tkinter import 





track = mixer . Sound (sound_file) | 


/ ef track__start ()7 " 7 

‘ ^fl^ifyOoops = I 


s t op_but t on = Button (app, command = track_stop, text = "Stop") [ 

stop_butt on .pack (side = RIGHT) | 


1 



a PP • mainloop ( ) 



button Button (app, command = track 
—tart— button . pack (side = LEFT) 



start, text = " 



Start") 



def track_stop ( ) : 
track. stop () 



mixer = pygame 
mixer . init () 



.mixer 




app = Tk ( ) 

app . title ( "Head First Mix") 
app . geometry ( ’250x100+200+100 ' ) 
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start and stop 




Cocte Magnets Solution 

A couple of buttons on a GUI ought to do it. Here's the code to a 
small tkinter program that starts and stops a sound file. You were 
asked to rearrange the code magnets to make the program: 



from tkinter import * 
import pygame. mixer 



r 



app = Tk ( ) 

app. title ("Head First Mix") 
app . geometry ( ' 250 x 100 + 200 + 100 1 ) 



.port the required libraries- 

Create the ^U| applidaW window. 



Identity the £> J's tradk. 

4 



-rT^rr^459_M,RED^ephlimi^.wav'' 

Start the sound system. 




The “tradk_stop0" tundtion 
will respond to the "Stop" -V 
button-dlidk event- 




track = mixer . Sound (sound_file) 



The traek_startO ; -function will respond 
to -the w £tart” button-eliek event- 

.The “loops - -I" parameter to “playO' 
repeats the tradk until you stop it- 



Load up -the tra^k sound -Pile- 



Create a button -for 



start__button = 

ured'ce d uwuivn ^ i . l a PPd command = track 

“Start" and “Stop," then -T L? tar t— but ton . pack (side = LEFT) 

tonnefct eath o$ them toN^ 



s tart , text = » 



Start") 



their event handlers. 



/i 

Start the 6jlAl event loop. 



stop_button = Button (app, command = track_stop, text = "Stop") 
stop_butt on. pack (side = RIGHT) 



app . mainloop ( ) 



* 



r 



Lmdihfc! 



Download the sound tracks for this chapter from the Head First Programming 
website. Be sure to put the sound files in the same directory/folder as your code. 



316 



Download at WoweBook.Com 



graphical Interface elements 




Tsst DriVq 



Enter the code from the previous page into IDLE, save it as hfmix . pyw, 
and press F5 to try it out. 



fofmiit.pYW ■ .'homeybarryp/Head First Proq/ctiapters/codeystaqeo- * 



File Edit Format Run Options Windows 



The -Piv-s-t vemsioh 
ot the DJ's 
pv-ogvann entered in 

ID LB. 



from tkmter * 

pygame . mixer 

app - Tk( ) 

app. title ( "Head Fir?" Mix") 
app. geometry [ 2 : ;:l : + 2 ) o+l oo ) 

sound file = ,IE ^04 l i I J W BEH Hfiph 1 i mi _ wn v" 

mi xcr ** pygame * mixer 
mixer . init ( ) 

J e r Li mj X a La 1 1 ( ) ; 

track . play ( loops - ^1) 

i r ■ i Lx ac k, a Lup ( J s 

track . □ top t ) 

track = mixer .Sound t 50 und_Eilej 



start button = Button(app x command = track, start, text = "Start") 
s t art_nut t on . pac k [ s ide = Lurr) 

stop button = Button(app r command = track stop, text = Stop ' } 
3top_button.pack{aide = RIGHTS 

app . mainloop ( ) 




In: 28 Col: 0 



You already know how to display buttons on a GUI and 
associate them with event-handling code. What’s new in this 
code is the loops = -1 bit, which arranges to play the sound 
repeatedly. That is, the track loops. 

That was almost too easy! 
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stop the music 



The music just kept on playing... 

In his haste to show off your program to his DJ rivals, your friend 
fired up the program as is. He didn’t realize that the track you 
included by default is pretty bad. In a panic, he clicked the window’s 
close box before pressing Stop, and the awful track just kept right on 
playing. His rivals haven’t had such a good laugh in ages... 





graphical interface elements 



Not all events are generated by button clicks 

Your GUI program processes lots of events, not just the events generated by your 
user when, for instance, buttons are clicked. 

Your operating system can send events to your GUI program, too. Some of these 
events are commonly handled by the graphical programming technology you 
are working with. For most of the operating system’s events, tkinter very kindly 
handles them for you. When you click the close box on your GUI, this generates a 
Window Manager event for your code to handle. If your code doesn’t handle a 
Window Manager event, tkinter handles it for you in a default way, too. 



Your user 
yner a*bes a 
button— tlitk 
event m -the 

$UI- 




\ L' 

Click! 



\ 




Wait tor another event- 




Head First Mix 




Ru* the event-handling Code 
associated with whatever 

v , — -v -n, CVeh ^ ‘’“''"redjar per-Pom, 

x j / / /£§§§& Q 
Click! " 



The Window Manager 
generates an event 
w hen the user clicks 
on the close box. 



If the default event handling isn’t what you want, you have to capture the event 
before it gets to tkinter and is handled in the default way. At the moment, the click 
on the close box is being handled for you by tkinter and the default behavior is to 
close the window. 

Let's take control of this default behavior. 
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the cost of interactive loveiiness 



Frank: What’s up now? 

Joe: Well, it looks like I have to worry about lots of other GUI 
events, not just my own. 

Jim: Yeah. It appears the operating system and this Window 
Manager thing can give the GUI application work to do. 

Frank: Yes, that’s right. All that interactive loveliness comes at a 
cost. 

Joe: Cost?!? You mean we have to pay? 

Frank: No, not that sort of cost. You sometimes need to write a little 
extra code to interact with the Window Manager when and where 
necessary... that’s what I mean by “cost.” 

Joe: Phew! So... what’s a Window Manager, anyway? 

Frank: It’s something built into every GUI application that handles 
the management of your application’s windows. Python’s GUI, 
tkinter, has a Window Manager, as do all the other GUI toolkits. 

Joe: So, how do I work with the events generated by the Window 
Manager? 

Frank: You create a function with the code you want to run and 
then connect the function to the event. 

Joe: OK, I get that. But which event do I connect up to? It’s not like 
the Window Manager has a button to click on, is it? 

Jim: That’s a good question... Frank? 

Frank: Well spotted. What happens with the Window Manager is 
that there’s a set of protocol properties that you can interact with as 
and when required. 

Joe: Protocol what ? Properties? 




Jim: Yeah, you’ve lost me there, Frank. 



Frank: Yes, protocol properties... they really are not as scary as they 
sound. Remember: with GUIs, it’s all just code. 



Jim &Joe: Where have we heard that before... ? 



Frank: Here, let me show you what I mean... 
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+ 



+ WMAT'S 

• + 



Study the three tkinter properties presented below and see if you can 
match up the properties to the correct description: 



Which of these protocol messages do you think you need to capture? 



The tkinter library provides a mechanism to 
react to an event that is associated with the GUI 
window These are known as Window Manager 
protocol properties. Think of the event as a 
protocol event. 



WM_T AKE_F OCU S 



A message sent to your main window 
when the operating system is shutting 
down 



WM_SAVE_Y OURSELF 



A message sent to your main window 
when the close box has been clicked 



WM_DELETE_WINDOW 



A message sent to your main window 
when the window has been selected 
after a mouse click 
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capture the event 



+ 






VWWAT* 




* 









You were to study the three tkinter properties presented below and see 
if you could match up the properties to the correct description: 




A message sent to your main window 
when the operating system is shutting 
down 

A message sent to your main window 
when the close-box has been clicked 

A message sent to your main window 
when the window has been selected 
after a mouse click 



You were to identify which of these protocol messages you think you 
need to capture: 

W/V\J)£L£Tt_W\bll)OW 




Controlling the Window Manager 



To capture the event before it gets to tkinter, call your app’s 
protocol () method and identify the function that should be 
called instead of executing the default behavior: 



You II have 
“shutdown* 



to fcreate 
-function- 



the 



Be sure to eall 
w protodolO" BEFORE 
U r*ainloopO*\ 



* 



app . protocol ( " WM_DELETE_WINDOW " , shutdown) 



<r* 



Associate the event- 
handling -function 
with the property. 
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shutdown function 




Now that you know about window manager properties and 
how to capture them, you were asked to write the code for the 

shutdown () function: 



from tkinter import * 
import pygame. mixer 

app = Tk ( ) 

app . title ( "Head First Mix") 
app . geometry ( '250x100+200+100' ) 

sound_file = "50459_M_RED_Nephlimizer.wav" 

mixer = pygame. mixer 
mixer . init ( ) 

def track_start ( ) : 

track . play (loops = -1) 

def track_stop() : 
track . stop ( ) 

drf shu*tdovmO: 

Si^ly a*r<ran$e for ^adk.stopO 

-tv-atk -to sto? playm$ 

when "the window dloses. 



track = mixer . Sound (sound_file) 

start_button = Button (app, command = track_start, text = "Start") 
start_button . pack ( side = LEFT) 

stop_button = Button (app, command = track_stop, text = "Stop") 
stop_button . pack ( side = RIGHT) 

tall *to — — ^ *. pyrp.'tpApj s^.id?.^? 

a^.wa'mloo^ app . ma inloop ( ) 
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graphical interface elements 




Tost Drii/q 



With the changes made to your program in IDLE, press F5 to see how things 
perform now. 



hfmlx.pyw - /hornaybarryp/HaadFfirEtFrogi'cliaptar^.eod^Gt^ + - “ i k 



£ilp Fdit form Fit 1 Run Options Windows 



tkintor * 

pyEjnnui-i . in i i«r 

13 L 1 ! 3 “ TV ( 3 

app .title [ Head first [■Ilk.") 
rt£ip _ [j+fi unK I r y ( ' 3 r i H x 1 fi fl t ? fi fl + 1 1 ji 

miiliik] ril*f => "'Vfji+'k^ H RF.n Nupllil ini 

r i km: = py . in 5 x r e 

ai-KiBr . in it i \ 

t racK_3ta rt [ ) : 

t. rnr.ii . piny ij l™np.i — — 1 ) 

: r £ K rn | J : 

track. stop < ) 

der sliutdown ( ) : 
track. atop i J 

track - mixer. Sound ( aound_filc \ 



track_p laying - IntVarf ) 

atart_Putton = But ton £ app F conraiaEid=track_start , text = Start) 
atart_button .pack( aide - LEFT} 

stop__Putton = Button ( app r command = tracfc_3top, text = "Stop" ( 
at op_button .pack ( aide - EIGHT) 



app . protoco 1 ( H WH_DELETE_KIHIK>W " , ohutdo 



app rcr.ain loop £ ) 

I 



What gives? You’ve solved one problem, but created another. 
When the DJ clicks on the close box, the track stops playing, 
which is what you wanted. But now, the window won’t close. 

This can't be good, can it? 




I 






Ko **fcfcer Ko* O-CW y* tV '* 

the dose W, tKe Vmdox 
0,0 avNav - 

\ l ' 

_ Cliet! " 

\ L [' > \ 

diet! " 

\ \ ! / 

^ Click! 

\ I ' ’ ^ \ 

diet! " 



\ \ 



/ \ \ 






\ J / 

click! 

) \ \ 



** IDLB **d 

, p ytu SWI to Awe tie 
wmdow io dlosc. 
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terminate with extreme prejudice 



Capturing the protocol event isn't enough 

Your code captures the protocol event and redefines its behavior. But, what 
about the behavior that used to execute by default ? 

Take a look at this small example program, which redefines the close-box 
protocol to check with the user before actually destroying the window: 



from tkinter import * 

from tkinter . messagebox import askokcancel 
app = Tk ( ) 

app . title ( "Capturing Events") 
app . geometry ( '250x100+200+200 ' ) 

def shutdown () : ^ — 

if askokcancel (title = ’Are^ytwi. sure?', message 
app . destroy ( ) 

\ 

app. protocol ( "WM_DELETE_WINDOW " , shutdown) 
app . mainloop ( ) 



'Do you really want to quit?') : 




|£ you c\\cV 0£, the is 
destroyed (whieh has the e-f-fett 
tlos'm^ the window). 



Add the app . destroy ( ) line of code to the end of your 
shutdown ( ) function and see if it makes any difference. 
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graphical mterface elements 




Tost DriVq 



You’ve added in the line of code that terminates (destroys) your GUI 
application. Now, press F5 to see what happens. 




Your GUI is not only doing what the DJ wants; it’s behaving itself, too. By 
redefining the protocol event associated with the click on the close box, you 
are able to stop the track... eh... in its tracks. You also ensure that the default 
behavior associated with the click is performed by arranging to destroy the 
GUI application. 

That's great! 




i \ \ 

T' 

VVhcn you eliek on -the 
dose ko% now, "the ^U| 
application disappears. 

Which helps explain wky you 
can t see it on this pa$e 
anymore! 
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Two buttons, or not two buttons? 
That is the question... 



The DJ is happy with the program so far. However, he thinks it would work 
better if he had just one button instead of two. He’s convinced this would be 
easier to use, because he wouldn’t have to move his mouse around the screen 
quite so much. 




M 2 buttons or not 2 buttons? + - n x 


Start/Stop 





_ MU the next click 
stav-t or stop whatever 
this buttoh docs? 



It is possible to use a single button here but, without changing the physical 
appearance of the button each time it’s clicked, a user can’t possibly know 
what state the button is currently in, even though the DJ does have ears in 
this instance. But, in general, using a button to switch between two states is not 
regarded as best practice in GUI design. 

What your DJ friend actually wants is some sort of visual toggle... 
something that can be flipped between one of two states: on/ off, open/ close, 
flip/ flop, and so on. You need to use a different graphical interface element. 



Is there a GUI visual toggle you can use here? 
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graphical interface elements 






ExenciSe 



Take a look at the following window that appears when you ask a full-featured web browser to 
display its preferences. Grab a pencil and draw a circle around any graphical interface elements 
you haven't worked with yet. 




From the elements that you have circled, identify one that might be of use to you in your program. Which 
would work best as an on/off toggle? 

IfVvrte youv- ansy/ev- hev-e. 
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check on the checkbox 






RciSe 

ivtioH 



Take a look at the following window that appears when you ask a full-featured web browser 
to display its preferences. You were to grab a pencil and draw a circle around any graphical 
interface element you haven't worked with yet. 



Shkretoko Preferences 



ttev-es a* 
elewcv't we 

haven't 



-> 



m 


Pi 




Q 


S 


0 


Main | 


Tabs 


Content Applications 


Privacy 


Security 


Advanced 



startup 

when shirrtokn starts: 



bhow my windows and mb's from last time 



Home Page: http://www.python.oig/ 




Use torrent Images 


use bookmark 


restore to Default 


Downloads 








f bhow rhe Downloads window when downloading afile^ 
\ D Close it when all downloads are finished ^ 




i® baye files rn 


O Deslctop 




Browse... | 



Always ask me where to save files 

Add-ons 

Change preferences for your add-ons 



ft Help 



Manage Add ons... 



)( Close 



F rom the elements that you have circled, identify one that might be of use to you in your program. You 
were asked to identify an element that would work best as an on/off toggle: 

The dhedkbo* is 

erthev* oh ov o££. The dhedkbo* 



330 



Download at WoweBook.Com 







graphical mterface elements 



The checkbox is an on/off, flip/flop toggle 



The great thing about the checkbox graphical interface element is that it can 
be in only one of two states, either on or off. Depending on the current state 
of the checkbox, an object can be set to either 1 for “on” or 0 for “off 55 




Click the checkbox 
to "tick” it and set 
the object to on- 




C.\tck the checkbox to 
“’’tick" it and set the 
object to Vf-f" 





0 






In tkinter, checkboxes are created using Checkbutton(), and they can be 
associated with a tkinter IntVar, first introduced in Chapter 7. The tkinter 
Checkbutton ( ) is either on or off and sets the associated IntVar to 
either 1 or 0, which is perfect for what you need. 

Let's look at using a checkbox in tkinter. 
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flip it off 



Working with checkboxes in tkinter 

The tkinter Checkbutton needs three things: an IntVar to hold its 
current value, an event-handler function to run when it’s ticked, and a 
descriptive label to say what it does. Take a look at this example code: 



The 

-function is -the 
Cbeckbu-fc Ws ^ 
eveivt handler. 



The Checkbutton * ^ 
associated wth the 
w |nWa/, l«»te the 
event handler, and has 
a descriptive label, too. 



L - — Create an |nt\/ar to hold a value that 
flipper = IntVar () is „:±i _ / - . ' d UC , that 

s cithc,r 1 <* °> depending on whether 
the checkbox is ticked. 



def f lip_it ( ) : 

if f Upper . get ( ) == 1: 

print ( "Cool . I'm all ON, man!") 
else : 

print ( "Phooey . I'm OFF.") 



Checkbutton (app, variable 
command 
text 



flipper, 
f lip_it , 

"Flip it?").pack() 
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Using the get() method 

If you look closely at the code for the f lip_it ( ) 
event handler, you’ll notice that the message displayed 
on screen is controlled by whatever value is returned 
from the call to flipper . get ( ) . The get ( ) 
method is part of every IntVar object, and it lets 
you easily determine, in this case, the current value 
associated with the flipper variable. 

But, what sets the value? 

The Checkbutton automatically sets the value of 
flipper as a result of the click on the checkbox. 
Tick the box and the value is set to 1 . Untick the box 
and the value is set to 0. 
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O Here's your code from earlier. Use your pencil to put a line 
through the code you don't need anymore: 



from tkinter import * 
import pygame. mixer 



app = Tk ( ) 

app . tit le ( "Head First Mix") 
app . geometry ( '250x100+200+100' ) 



sound_file = "50459_M_RED_Nephlimizer.wav" 



mixer = pygame. mixer 
mixer . init ( ) 

def track_start ( ) : 

track . play ( loops = -1) 

def track_stop() : 
track . stop ( ) 

def shutdown () : 
track . stop ( ) 
app . destroy ( ) 

track = mixer . Sound ( sound_file) 

start_button = Button (app, command = track_start, text = "Start") 
start_button . pack ( side = LEFT) 

stop_button = Button (app, command = track_stop, text = "Stop") 
stop_button . pack ( side = RIGHT) 

app. protocol ( "WM_DELETE_WINDOW" , shutdown) 
app . mainloop ( ) 

© Write the code you need to implement the checkbox here, based on the sample code from the previous 
page. Give your IntVar the name track_playing. Use track_toggle as your function name, 
and call the checkbox track_button: 
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O Here's your code from earlier. You were to use your pencil to put a 
line through the code you don't need anymore: 

from tkinter import * 
import pygame. mixer 

app = Tk ( ) 

app . title ( "Head First Mix") 
app . geometry ( '250x100+200+100' ) 

sound_file = "50459_M_RED_Nephlimizer.wav" 

mixer = pygame. mixer 
mixer . init ( ) 



checkbox added 




+ rnnWt- irt- 

~ + ~ r=l^k pi M o op n 



■J4- 



er f — brack Gt o pO. 
— track ret op ( 1 



The functions -that start and stop 
-tv-a^k ave *o lor^ev- needed- 



def shutdown () : 
track . stop ( ) 
app . destroy ( ) 

You £an also jet v-id <rf -the -two bu-tfcons, 

track = mixer . Sound (sound_f ile) sinde they aren't needed either. 

l£ 

start_button - Dutton (ap - p - , — ^rnm-inH = — t ext - "utart ”) — 

p^kf°jd Q - pFFT t ^ 

stop_hutt^n ~ Fn + ty^ ^pp ^ nnm m and = track — text — — “- Stop" -) — . 

^—aJ^ep i_but. Lun . pad ( s i de = FT - GHT) 



app. protocol ( "WM_DELETE_WINDOW" , shutdown) 
app . mainloop ( ) 



0 



Write the code you need to implement the checkbox here. You were asked to give your IntVar the name 
e track_toggle as your f 

^ dc-f 'tradk^'bo^lcO: 



track_playing, use track_toggle as your function name, and call the checkbox track_button: 



I!th^la5rS?s^hf ^ 'i ~ 1 [ . . All of this Code needs to 

tratk, based on the state of k atk .? ,a Y ,00 F s ,'R 



be added to your program 
BEFORE the tall to "app- 

mainloopO • 



the checkbox. else: 

tratk.sto^O 
tradk_j>layin3 — IntVarO 

track_button — CheCkbutton(ap j>, variable — track_j>layin<j, 

Wse the name of the sound Command — track_to(^le, 

tile as the text associated — ... ~ 

with the checkbox. ..ilFFr . ■> . «« - !«/. . . . 



't\radk_bu't*tor\.padkO 
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Tost Drii/q 



With your program amended to include the checkbox code, let’s 
run the latest version of the DJ’s program in IDLE and see if the 
checkbox works as advertised. 



hfmix.p^w - ^omei'barrYp/HeadFirstProMj/chflpterSijCi * - □ 



rilp flriit njrmiiT flan Qjptinfis 



il^P 



Fr -im t fc I utcr " j. . - rt * 

; ■ pyqamc . nsi xer 

app * TkJ ) 

npp. t J tin [ "Si 1 rtrl rir.Tt 
a jjjj . qt? ume Li; y J ‘ 1 Ti 0 jl 1 0 0 + 2 D B + 1 0 0 ' ) 

sound tile - - 3 [1439 n Jltlil Nephiiiaizcr .wav" 

muijcex ■ pyqdjne . 

nixer. In.it ( i 

d"e-£ track toqqle [ ji i 

iidvk play i.9i>yi . ytfL ( \ -- 1: 

t racX . play \ 1 oops * -1) 

L ■ >. . 3(.up| } 

trade - r.iMcr. bound 4 sound file] 

L l •ocrX_pI ay Lzsy: ■ IiiLVar [ 1 

trnfik button - ChroktYuht onJ .npp r vnrinh-Lri — hmok plnyinfj, 

command — track toqqLe, 
teKt « Hound_JE 1 la } 

tracK_buttoni paoht J 

Ji . a >LU,"_dcjw:: ij j z 

track. atop ( ) 
app. destroy { ) 

app.piDlvvatl “f n!_DELETE_WmC-jH* * ahLitdjuwzi } 
app .main loop \ J 



J 



Lri: 34 Orf: Ol 



Creating the program bit by bit is working out. Each time 
your DJ friend needs something new, you incrementally 
improve the program in order to provide the functionality 
he needs. Of course, there’s always something new. 

Will this guy ever be satisfied?!? 



ccrv 




Sweet! Tootle the sound 
on and otir by simply 
dt.dk.n5 on the dhetkbo*. 



Head First Mix 
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add a slider 



Pump up the volume! 



To make the program more useful, the DJ wants to be able to dynamically 
and interactively control the volume of the track as it plays. Basically, as the 
track plays, the DJ wants to fiddle with the volume. 







In the physical world, most devices 
that have a volume control provide 
either a large, circular knob or 
a slider on a scale: 




J? IF J? F £■ 



f / / 

/ ^ f 



I * * , n j ■ j j I * < 1 1 f 




The ton-tvol 'ook 1U, 

a slider that t» " oved 
left (dow> to r.o>ht (*?'- 






Because a slider is much easier to manipulate with a click and drag of a 
mouse than a knob, the slider on a scale is used in lots of modern GUIs. It’s the 
classic choice for showing a volume control. 



°r the ionitol 

lock like this, 
f*** 't up to th e 

le^t' d ° Wh 



Look closely at the slider. What do you need to model? 
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Model a slider on a scale 

There’s quite a bit going on with a slider on a scale. It’s a simple control that 
everyone’s familiar with, but the simplicity masks quite a bit of complexity. 
The devil is most definitely in the details: 



Here's -the standard 
representation o( a 
slider on a seale that we 
all know and love, v 



This end oUhe ^le 

w arks a LOW value- 



I +. S- * I 1 < -i I I h < | 



4 —* 



There's a hundh ot marking on ike 
devide ikai indidate where on ihe 
sdale you durrenily are- 



C 

FI 



This end ot the sdale 

m3 rks a 



\ 

TP? is something 
that you dan grab onto 
a«d slide iron, left & 
nghi 



r <^|arpen your pencil 



Look at the volume control shown above and identify four key 
characteristics of the volume control. 



Write your -Pour answers here. 

1 . ...... 



2 . 



3 . 



4 . 
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Sharpen your pencil 

Solution You were to look at the volume control on the previous page and 

identify four key characteristics of the volume control. 

i There's a scale -that joes -from a low value *to a hi jh value. 

2. The scale has a -fixed se*t o-f irrtervals. 

3 The volume CoK*trol u slider” moves -from le-f*t *bo rijh*t- 

4 Mov'mj *the u slider" dynamically adjusts the Volume based on its Current 
position on the scale. 



Start with the volume 

Before you start worrying about creating the appropriate GUI interface 
element to actually model the slider, you first need to know how to adjust the 
volume of a track. 

Once you know how to adjust the volume, you can then start to worry 
about linking the volume to the slider, with the current position of the slider 
dictating the current volume setting. 

Then you can allow your user to move the slider which has the effect of 
dynamically and interactively adjusting the volume. 

Sounds easy, eh? 



338 



Download at WoweBook.Com 



graphical interface elements 



Use pygame to set the volume 

Turns out pygame has this functionality built right into its library code via the 
set_volume() method. 

Take a look at this small example program: 



import pygame. mixer 
from time import sleep 

mixer = pygame. mixer 
mixer . init ( ) 

track = mixer . Sound ("50459_M_RED_Nephlimizer.wav") 
print ("Play it LOUD, man!") 
track . play ( loops = -1) 
track . set_volume ( 0 . 
sleep (2 ) 

print ( "Softly does it ... ") 
track . set_volume (0.1) Set the volume *to 

sleep (2 ) 
track . stop ( ) 



— 1 ) 

, / Se ^ the volume io a LOUD 

• 9 ) se-fc-fcihg. 



a vevy low setting- 




/ / / f * 

/ / 



rv 







/ 7 7 * * 

/ ^ / 

■ / 



r 

Louder, dude, louder/ 



\ 

Twv. tkal v-afket 




When you set the track’s volume to a high value using set_volume ( ) , it’s 
the equivalent of cranking up the volume by moving the slider to the right. When 
you set it to a low value, that’s like moving the slider to the left. 
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Use tkinter for everything else 

The tkinter library has a graphical interface element called Scale that lives 
to help you create a slider. Take a look at this example code and let’s see how 
it works: 



Grea-te a -tkin-ter £)ouble\/ar variable. Like 
|ivi\/a\r and SLrincjl/ar, ■the Doublel/ar variable 
s-fcores a u r*a<)i£ w value, -this -time a -float 



Tbe tkmter Stale 
widget treatcs a 
slider. 



volume = DoubleVar() 
volume_scale = Scale (app, 

variable 
k from_ 

^to 

resolution 
command 
^ label 
orient 

volume_scale . pack ( side = RIGHT) 



Tbe slider £an be linked 
to a variable. 



Speti-fy tbe lowest and 
tbe HIGHEST values on 
tbe stale. 

Provide a Kite, human- 
-friendly label -for tbe 
slider. 




Speti-fy tbe 
resolution value, 
wbitb inditates tbe 
interval. 



4 ^ — C°*»ett the 
w 'dget to an 
event handler. 



r\ditate whether the slider 
runs atross the streen 
(HORIZONTAL) or up tbe 
streen (VERTICAL). 





The Scale ( ) element is your most complex tkinter widget yet. But, despite 
this, it is not hard to work out what’s going on here. The graphical interface 
element is linked to a tkinter DoubleVar (called variable), the lowest/ 
highest slider values are provided (to and fromj, and an interval between 
them (resolution) is specified. The event handler is assocated with an 
event handler (command), a descriptive label is supplied (label), and, finally, 
the orientiation of the slider is specified (orient). There’s a lot going on 
here, but none of it is that hard to understand. 
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St The Scaled code on the previous 
page has a variable called from_, that is, 
the word "from" together with a trailing 
underscore. Was that a typo? 

No, it wasn't a tyop, eh, typo. The 
reason for the underscore has to do 
with the fact that Python uses "from" as 
a reserved word. These are words that 
Python uses for its own special purposes, 
which means you cannot name one of your 
variables after a reserved word. As using 
the word "from" makes a lot of sense when 
taking about a scale, the authors of tkinter 
decided to tack on the underscore so that 
the meaning of the variable would be clear, 
while allowing for the variable name not to 
clash with a reserved word. 




Are there other reserved words? 



Yes, a few. And every programming 
language has its own list. In Python, words 
like "while", "for", "if", "def", "class", and 
"pass" are all reserved words. 



% 



What happens if I use one 
anyway? 



Python will most likely complain with 
a syntax error. 




Where can I find a list? 



Any good Python reference book 
will contain a list, and it's also included as 
part of the Python documentation that's 
installed with Python on your computer and 
available on the web at the main Python 
website. 



there 1 are no 

Dumb Questions 



% How do I know which graphical 
interface element to use and when? 



This is really a matter of experience. 
However, a lot of platforms goto great 
lengths to specify exactly when each of 
the elements should be used and for what 
purpose. Of them all, the Macintosh is the 
leader of the pack. Apple's engineers have 
worked hard to strictly enforce consistent 
usage of the Mac GUI among programmers 



O: So, it's a case of anything goes 
with the other operating systems? 



No. That's not what we are saying. 
The Apple folks are very strict with their 
rules and regulations, and the others are 
less so. But there are still standards that 
you should try as much as possible to 
adhere to. One of the reasons for using 
a GUI is thatyour users will expect your 
program to work in a standard way. This 
makes your program immediately familiar 
to new users and lets them become 
productive with your program more quickly. 



% So there are no badly designed 
GUIapps? 



No. There are plenty of howlers out 
there... and they tend to be harder to use 
than necessary, due to the fact that the 
programmers responsible for creating them 
did not conform to established interface 
standards and practices. When it comes 
to GUI programs, conformance is a good 
thing. 



Q So does tkinter work well on all 
platforms? 



The latest version of tkinter (which 
comes with Python 3) is pretty good. If 
you run your tkinter program on a Mac, it 
looks like a Mac OS X program, whereas 
on Windows it looks like a Windows 
application, and on Linux it takes on the 
look and feel of the graphical environment 
you happen to be using (there are a few 
choices on Linux). 



Q; Other than tkinter, what other 
graphical toolkits does Python support, 
and should I learn any of them? 

Python supports lots of other toolkits 
on lots of operating systems. For now, 
tkinter is all you really need, and you 
shouldn't worry about the other choices 
until you are in a situation where learning 
how to use them becomes a necessity. 
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control the volume 



M 



£oh£ ExeRciSe 



Take the pygame and tkintercode and combine it to support a volume control. Then, complete 
the next version of your program. 



from tkinter import * 
import pygame. mixer 
app = Tk ( ) 

app . tit le ( "Head First Mix") 
app . geometry ( ' 250x100+200+100 ' ) 

sound_file = "50459_M_RED_Nephlimizer.wav" 

mixer = pygame. mixer 
mixer . init ( ) 

def track_toggle ( ) : 

if track_playing . get ( ) == 1: 
track .play (loops = -1) 
else : 

track . stop ( ) 




dumpily plays at 
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track = mixer . Sound (sound_f ile) 
track_playing = IntVar() 

track_button = Checkbutton (app, variable = track_playing, 

command = track_toggle , 
text = sound_file) 

track_button . pack ( side = LEFT) 



f dd tV»e tode 

w»fle»e«vfc* 

volume 

Lo»bco\ V^eve- 




def shutdown () : 
track . stop ( ) 
app . destroy ( ) 

app. protocol ( "WM_DELETE_WINDOW" , shutdown) 
app . mainloop ( ) 
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volume controlled 



u 



£on£ Exercise 
Solution 



You were to take the pygame and tkintercode and combine it to support a volume control, 
then complete the next version of your program. 



from tkinter import * 
import pygame. mixer 



app = Tk ( ) 

app . title ( "Head First Mix") 

. , . . > app . gcomcLr^ ( 1 25 0x100 l 2 0 -0-itL CrCr 1 ) 

TWmy ave staving to — "7 

yt d v-owded on "the ^U|, 
so lei's have ikmiev 
awWatidally dedide 
OY\ -tV>c yomc-br^f -Coit- 
us. Remove the w app- 
yometryO” eall -Cvom the 
tode. 



sound_file = "50459_M_RED_Nephlimizer.wav" 

mixer = pygame. mixer 
mixer . init ( ) 



def track_toggle ( ) : 

if t rack_playing . get ( ) == 1: 
track . play (loops = -1) 
else : 

track . stop ( ) 



Put the 

pygame £ode 

de-C dhange^volume^v): 

tv-a^k.set__volumefvolumegetO) 
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track = mixer . Sound ( sound_file ) 
track_playing = IntVar() 

track_button = Checkbutton (app, variable = track_playing, 

command = track_toggle , 
text = sound_file) 

track_button . pack ( side = LEFT) 



Pwt tV\e -tk'm-tev ^ . . volume =•_ D<^bleYav;0 

volumesetTratk.<y:-fc_volumeO) 
volume stale — Stale(vav-iable =• volume, 





- 00, 


*fco 


-lo, 


\rcsolu*tioh 


- o.l, 


tommdrd 


— dhol^c__volumc ; 


label 


- ‘Volume", 


ov-ierrt 


- miZOHTAU 



volume_stalepatk(side — R|£)HT) 



def shutdown ( ) : 
track . stop ( ) 
app . destroy ( ) 

app . protocol ( "WM_DELETE_WINDOW" , shutdown) 
app .mainloop ( ) 
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test drive 




Tost Drivs 



Let’s take the latest version of the program for a spin in IDLE. In addition 
to turning the sound on and off with the checkbox, you should be able to 
dynamically and interactively adjust the volume with the slider. 



hfrrMk.pyw - /Henne/barrYpVHaadFiiFAtFreqi'ehaprfrr^eode^sla! * - 



r ilt? 5 dit Fur nidi Run Qpliunv WimJuwv 



[run Lh.int.er irapuL ' * 

pyq-anie . miy.ri 

app 1* Tk£ S 

app . t it 1c { " iicad iirat Hik'J 



ecf t 



imi nd f i \ e 



M am Kr.ph% ini t.pt ,ha v 



.mixer * pyq-ame . mj.ic.e.c 
mi rex -i.ni.tl \ 

if r t r ach_togg le(>i 

: track_p Laying. gen £ J «- is 
track .play £ loopa - 
: 

trunk } 

! I £ c!h.anige vu Lume £ v J- : 

LraE.ih.sei vul ume [ vOlurr . yeL£ } 1 



f rac k - r. Iko r r Sound £ h g u n d_£ i La S 
t rac Kjpiay ing - lntVar( J 

t rac k_LHJtton - oncckbuttcrUapp, variable- » track_piaying, 

nnrnrannrl -• trank Lrigglr, 




text. 



nonnri filr^ 



L x at: k._!bij L Lun . patrh £ side ■ LEFTS 

vuluima — Du-ub LeVax £ ) 

volur.e . Hat {track. gat_volujra [ J j 

voluse_acaIc ** 6ca,lc( variable - volume, 

I rom_ - W * tf , 

to a id, 

rrnolutirm - fli-t, 

ocHraiusnd - chanc|r_wil urne r 

lalael ■ “Volume" , 

orient - HOBIIOMTJLLJ 

volujw_HcaLe .pack£ aids * RIGHTS 

d>? [ ahutCown(>£ 

track. stop £ \ 

npp . dn.nt.rny £ } 

app. prur-utzuLf “ HMDSXETEWIHBQW" r sSiuLeJuwel] 
app . iba in lurjp£ \ 



in: 45 col: 0 



Twvn ii way wf • 



It works. Not only can you 
start and stop the track, 
but you can now adjust the 
volume, too! And all from 
the one GUI... sweet! 



346 

Download at WoweBook.Com 






graphical interface elements 



The PJ is over the moon! 

Your code has shown the DJ that his idea for the Ultimate Music 
Mixing program is not as far-fetched as everyone once thought. With 
his idea, talent, good looks, and — above all else — modesty, together with 
your coding skills, the world’s the limit for what you can accomplish 
together. The World Music Mixing Expo is next month, and the DJ 
can’t wait to show off your completed software. 





JJ13 



d Wow! This is really 
fabulous... I can now start 
converting all my vinyl tracks 
and, thanks to your program, 
my laptop is on its way to 
being my music mixing desk! 



I 



j- 



k » J33 




r tfT V 
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programming toolbox 




Your Programming Toolbox 

You've got Chapter 9 under your belt. 
Let's look back at what you've learned 
in this chapter: 



froW*"'"' ^ ;S ^e^ Ao>NS ^ 1 
‘ ^ . Mav>ay vw,ar ' a?> ^ 

* ^U\ 6 , 1 V^sev. fc, lode 

OH w OFF- . t 

* * i*/** <* r '- W 

'■**- di 3rt ^ - -«* 
?vo ^" w V a ^ 0 



,a«*'C s - 



jVfccn 7-oo/s 

°« c u*iU0 

aneafc— -. 



*nd 5{irj h a [/ 

^ *«£:-**> 



-boxes ' w ‘ w,< V*-fc 

* &a/eO 

***/*den ***** * 



' t{r eai; 



J »5 
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10 custom Widgets and classes 

* With an object in mind + 




Requirements can be complex, but programs don’t have to be. 

By using object orientation, you can give your programs great power without writing lots 
of extra code. Keep reading, and you’ll create custom widgets that do exactly what you 
want and give you the power to take your programming skills to the next level. 
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mixing muitipie tracks 



The PJ wants to play more than one track 



The World Music Mixing Expo is only a few weeks away. Your DJ friend is 
thrilled with the work you’ve done, but now he has a few extra requirements. 

Just playing one track isn’t enough. To be useful, the program needs to be able 
to mix several tracks together at the same time. Each track needs its own 
graphical interface elements (or widgets). 



I can fade a track 
in and out, but that's 
not enough. I need to 
be able to mix several 
tracks together. 



How will you create the widgets for each track? 

To play and control a single track, you created two widgets on the GUI: a 
check button to start and stop the track and a scale to change the volume. Then 
you added event-handling code to hook those widgets up to the sound 
system. 





To play multiple tracks together, you just need more of the same. Each track will 
need its own set of widgets and its own event handlers to connect the widgets and 
the track together. Then, each set of widgets needs to be added to the same 
window in the GUI. 



Let's generate the widgets and event handlers. 

350 Chapter 10 

Download at WoweBook.Com 



custom widgets and classes 



Create code for each track as a function 

You could just copy and paste the code several times for each track. But 
duplicated code is a bad idea, because it can lead to all sorts of problems 
whenever you need to change how the code for each track works. Instead of 
duplicating code, you should always try to reuse it. 

One way to reuse code is by creating a function that will generate the widgets 
and the event handlers as needed. 




-Punttion, when tailed, tould 
£reate the inter-Pate -for a 
single tratk a s needed- 



jpl nead. First mix 


f o |( tflbL 




n * 




XT 



If you have a function that creates the widgets and event handlers for a single 
track, you could call it for each of the tracks, which would then quickly let you 
build the entire interface. 

But what code would you need in such a function? 
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m 



£oh£ Exercise 



Here is the code from the end of the previous chapter. Study it carefully, and then, in the 
space on the next page, write the code for your new function (based on the code below). 



from tkinter import 
import pygame. mixer 



Be<yn by imfortrn^ tbe 

libraries you need- 



Create tbe (\\k\ affkation- 



app = Tk ( ) 
app . title ( "Head First Mix") 

sound_file = "50459_M_RED_Nephlimizer.wav" 
mixer = pygame. mixer 
mixer . init ( ) 



" initialise -the 

sound system. 

def track_toggle ( ) : 

if track_playing . get ( ) == 1: 

track. play (loops = -1) ^ even t-handler U* 
else : detail what happens when an 



track . stop ( ) 



event oddurs. 




def change_volume (v) : 

track . set_volume (volume . get () ) , 

pe-fine tbe dbedkbo* u/id^ct- 

track = mixer . Sound (sound_file) 
track_playing = IntVar() 

track_button = Checkbutton (app, variable = track_playing, 

command = track_toggle, text 
track_button . pack ( side = LEFT) 

volume = DoubleVar ( ) Pe-fine the slidev widget- 

volume . set (track . get_volume () ) 

volume_scale = Scale (variable = volume, from_ = 0.0, to = 1.0, resolution = 0.1, 

command = change_volume, label = "Volume", orient = HORIZONTAL) 

volume_scale . pack ( side = RIGHT) 



sound_f ile ) 



def shutdown () : ^ . 
track . stop ( ) 
app . destroy ( ) 



fondle a click 
the close box. 



I 



app. protocol ( "WM_DELETE_WINDOW" , shutdown) 

app .mainloop ( ) tc . , . . 

^Stav-t the event loop. 
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function created 



m 



£ ortg ExeRciSe 
Solution 



Here is the code from the end of the previous chapter. You were to study it carefully, and then, 
in the space on the next page, write the code for your new function (based on the code below). 



from tkinter import * 
import pygame. mixer 



app = Tk ( ) 

app . title ( "Head First Mix") 

sound_file = "50459_M_RED_Nephlimizer.wav" 

mixer = pygame. mixer 

mixer . init ( ) 

def track_toggle ( ) : 

if track_playing . get ( ) == 1: 
track . play ( loops = -1) 
else : 

track . stop ( ) 

def change_volume (v) : 

track . set_volume (volume . get ( ) ) 

track = mixer . Sound ( sound_file ) 
track_playing = IntVar() 

track_button = Checkbutton (app, variable = track_playing, 

command = track_toggle, text = sound_file) 
track_button . pack ( side = LEFT) 
volume = DoubleVar() 
volume . set (track . get_volume ( ) ) 

volume_scale = Scale (variable = volume, from_ = 0.0, to - 1.0, resolution = 0.1, 

command = change_volume, label = "Volume", orient = HORIZONTAL) 

volume_scale . pack ( side = RIGHT) 

def shutdown ( ) : 
track . stop ( ) 
app . destroy ( ) 

app. protocol ( "WM_DELETE_WINDOW" , shutdown) 
app .mainloop ( ) 



354 



Download at WoweBook.Com 



custom widgets and classes 



Begin by iwpov-Ug 
the libv-av-ies y ou 
»eed to use i* this 
module. 

Create a new -(Wtiott 
that Contains the ^U|- 
ev-eat'm^ tode *fv*ow» the 
duvrent program. 



; 'f\rom ikihier. i | T*pp. v rrt. 






de-P £v-eate^ui(app, r*i*ev, souttd_£ile) : 

de-P -tv-a^k ; to^lcO: 

i-P ‘bradk^flaym^^c-tO — |: 



ivadk f layOoops =• -I) 



else* 



iv-aeks-topO 



de-P eka^^e^volum e(v): 

-tvadk.se-t_volume(voluw>e.^eiO) 



. iradk .=•. . rni^<y;.£pund(?pv»n<l. ..file). 



f ^r' S tode is P^t 

°+ the -function, so it , 

weeds to be indented. ""5. .(..... .trad.k^p.lay'm^. =. | niVSftrO . 



i^t]<_buttoK — Cbcdkbu^twnifapp, variable — ~b~adk playir^, 

dommand — ■b _ adk_fcoc^le, 

■tey.'t — sound_file) 

-tvadk_bu-t-fco^.]>atk(sidc — LEFT) 

volume — DoubleVav-0 
volume-seif tv-adk.^eij/olum eO) 

volume_sdale — Sdalef variable — volume, -(Vom — 0.0, -fco — l-O, 
resoluiioin — O.l, Command — dhan$e_volume, 
label - Volume", ov-ie»i - HORIZONTAL) 
volume_sdale-padk(side — RkjttT) 
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The new function contains other functions 



With all the code gathered together in a new function, the code for the 
create_gui ( ) function looks like this: 



This -Puhd-fcioh is 

LOCAL bo the 

Veate_guiO"_ 

TUh£-tioh. 



This WW ,s 

LOCAL, too- 

We* this 
tundtion is 

^lled, it starts . 
executing -Prom 
here. 



As aWf > 
the tails to 
"^a tkO’ add 
the 'widgets to 
the $WI- 



from tkinter import 
import pygame 



A^ote: When this Wtion is called, 

' l “ ex P ed 'ting three parameters. 



def create_gui (app, mixer, sound_file) : 

V def track_toggle ( ) : ^ 

if track_playing . get ( ) == 1: 

track. play (loops = -l) These are the event 

else: 7 handlers, 'whith are 

tr,ck stop<l * 

def change_volume (v) : 

track . set_volume (volume . get ( ) ) 







track = mixer . Sound (sound_file) 
track_playing = IntVarO 

track_button = Checkbutton (app, variable = track_playing, 

command = track_toggle, text = sound_file) 
track_button . pack ( side = LEFT) 
volume = DoubleVar() 
volume . set (track . get_volume ( ) ) 

volume_scale - Scale (variable - volume, from_ - 0.0, to - 1.0, 

resolution = 0.1, command = change_volume, 
label = "Volume", orient = HORIZONTAL) 
volume_scale . pack (side = RIGHT) 




Do you notice anything strange? The new function actually has two other 
functions inside it. Python (and several languages) lets you create local 
functions. A local function is just a function inside a function. 

Let's see why they're important for the DJ 's program. 



A function-in-a- 
lunction is called 
a local function. 
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Your new function needs to create widgets 
and event handlers 

When you’re wiring up the widgets in the interface, you need event handlers 
to respond to changes in the state of the widgets. If someone clicks the 
checkbox to play the track, the track_toggle ( ) event handler gets called 
and switches the track on or off 

But if you are creating several checkoxes, you are going to need a separate event 
handler for each of them. 

That’s why you have local functions inside create_gui ( ) . As well as creating 
new widgets for the interface, it also uses the local functions to create new 
event handlers. 



Each widget 
needs its own 
event handler. 




This is a hew 
Che^kbu-fc-fcoK. 



bratkJj^^eO 

This is a new thetkbo* ^ 
event handle’ 1- 



£hdfije__voluirneO 

This is a new slid®'' 

event handler 



dv-eate__^wiO ^ 



Now, let's update the program to use this new function. 
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Functions inside of functions inside 
of functions inside of functions... 
now, that's what I call complexity. Of 
course, everything's local, you know. 



Frank: A function inside a function? Surely that’s not legal? 

Jim: Well... it depends on the programming language. 

Joe: Don’t tell me this is something that only works with Python?!? 

Jim: No... there are lots of programming languages that allow you 
to put a function inside another function. 

Frank: Name one (other than Python)! 

Jim: Pascal. 

Frank: Pasc... what?!? 

Jim: Look, it really doesn’t matter which programming language 
supports this feature. What is important is that we can do it. 

Frank: And by “we” you mean “Python.” 

Jim: OK, yes. Python can do it. 

Frank: That’s all I was trying to say... 

Joe: So, this is cool how? 

Jim: Because it lets you localize functionality and handle complexity. 
Joe: What?!? 

Jim: Look: if a function gets big and complex, it can help to break 
the function down into a collection of smaller functions, just like we 
do when programs get big. We can keep the functionality local to the 
code that needs it inside the function. That way, we keep things as 
simple as we can 

Joe: Even if the code itself is complex? 

Frank: Like the GUI-building code we are working on now? 



Jim: Yes. 



Frank: OK. A function of functions it is, then. I’m all for keeping it 
simple, stupid. ;-) 



Joe: Yes, I like KISS, too. 



Jim: Yeah... their last album was really something special, wasn’t it? 



Frank & Joe: Eh?!? 
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E%enci$e 



Begin by putting the create_gui ( ) function in a separate module called sound_panei . 
py. Then, write a new version of the hfmix.pyw program that uses the sound_panei .py 
module: 

WVi-te yowv- tode heve- 
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sound panel 




ExendSe 

SoLutlON 



You were asked to begin by putting the create_gui ( ) function in a separate module called 
sound_panei . py. Then, you were to write a new version of the hfmix . pyw program that 
uses the sound_panei .py module: 



•fvom -tk'm-fce*- import & 

/"fort all the 

TUhd-tiohS -{Vor* Irom Sound^a^d impoV't ^ 

■the hew module. 

iimpo\rc py<jamC r«i%CV- 



app^TkO 

app.title( w Head First /VJiy.") 



r*i*e\r ~ .p.Y 5 ^c.rp\i^c\r 

nr\i%e\r .’mrtO 



By eallmj the new <^te^ui(app, 

dreatT TWO ^sets of tre^^uifapp, mixer, "V?l !3_M_R£D_HdrdBou^ 

SOUK>d tO^V-oU OK ”tV\C 

6jlA\. 

dc-f shu-tdov/hO: 



t\radks*kpf) 

app.dcs*t|roy() 



app .prota £ol ( u tV sliutdowh) 
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Tost 



DriVq 



With the code typed into IDLE, take this latest version of the DJ’s program 
for a quick spin by pressing F5. 



These thefik bu-tW 4. 

o J* J- CCf / ij~ 

m 





Head First Mix 



Bgvl Volume Volume 

W 50459_M_RED_Nephlimizer.wav 17 49119_M_RED_HardBouncer.wav j j 0.9 







These stales eorrbrol 
-tv>c volume. 



The program has created a checkbox and a volume slider for each track. 
The program called the create_gui ( ) function twice , creating two sets 
of widgets. Of course, you can call it as many times as you like and the 
create_gui ( ) function will create the two widgets for each track. 

When you click on the two checkboxes, the two tracks both play at the 
same time\ You can start and stop each of them independently by selecting 
and deselecting the checkboxes. But more than that, the volume sliders 
independently change the volume of the tracks, allowing you to mix them 
together. 

This is a big deal. The create_gui ( ) function is not only creating the 
separate widgets and adding them to the interface, but it is also creating the 
event handlers that allow each pair of widgets to control each separate track. 
Here the program is controlling just two tracks, but if you added more calls 
to create_gui ( ) in the code, there’s no reason why you couldn’t get the 
interface to work with as many tracks as you like. 



Let's see what the DJ thinks. 
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The PJ is confused 

The program does exactly what the DJ wants, right? Well, not quite. 




How am I supposed to 
know which volume scale 
is for which track? 



Volume 

W 50459_M_RED_Nephlimizer.wav I? 491I9_M_RED_HardBou ncerwav 0.1 



The problem is that even though the program technically works, it has 
a confusing interface. All of the checkboxes are added on the left of 
the interface, and all of the volume controls are on the right. 

There’s nothing in the interface that indicates which volume scale 
goes with which track. 



Track #1 or track #2? Tv . atk or track #1? 



The checkboxes are labeled with the filename of the track, but the 
volume sliders aren’t. Even though each volume slider is linked to a 
single track, there is nothing in the interface that tells the user which 
track that is. 



So... what to do? You could just add labels to each volume slider. 

That would probably fix it, but adding more widgets, like labels, can 
make an interface more complex. And you want your interfaces (and 
your GUI code) to be simple and clean. 

Fortunately, there is a way of rearranging the widgets in the interface 
to make it a lot clearer. 



"To avoid £orvfusion, 






the £ju| needs to look 
something like this. 
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Group widgets together 

If the interface were laid out with the checkbox for a track grouped 
alongside the volume slider for the same track, it would look better. 

Each track could then have a row of widgets associated with it. As long as you 
know which widgets belong to which track, you can load a lot more tracks at 
once without the checkboxes and sliders getting separated (and without your 
users getting confused). 

The program currently uses a function to add the checkboxes and sliders to 
the interface one widget at a time. If you call the function several times, the 
computer creates two more widgets with each call. But the widgets are not 
grouped. So, how do you group widgets together in a GUI interface? 

Create a new type of widget 

What if you don’t just hand the computer a set of instructions? What if you 
give it a brand new widget instead? 

If you create a new kind of widget that groups a checkbox with a slider, 
you can add your new widget to the interface and then guarantee that the 
checkbox and slider stay together: 




O 







0 



S04 S9_m jJepHirrasr i£&J 



& 



. Yowv nevj v/id^et 
u ^|i*es to^ethev- 

the other wdyts 
so the7 aUays 
stay <yrou?ed 




Your new widget becomes a new building block for your GUI interface. 



So, how are new widgets created? And how do they work? 
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A frame widget contains other widgets 



Most GUI libraries (including tkinter) let you create custom widgets from a 
set of other components, and tkinter includes a special kind of widget called 
a frame. A frame works just like a picture frame, in that it surrounds other 
things. It’s rectangular and it can contain other widgets: 



f\ £rame is like- 
a -frame- 







In tkinter, a frame is created using Frame ( ) . If you can work out a way to 
create a new type of frame (called, say, SoundPanel) that contains the checkbox 
and the slider, then you could use code something like this in your program: 



Create a hew 
SouhdPahe! 
widget- 



These are the same parameters you 
passed to the w dreate__guiO method- 




You eah add your widget to the 
4 Ml using the paeker, just like 
with all the other widgets- 



This look like a great solution. However, you still have a big problem. 




Even though you 
haven't created the 
SoundPanel code 
yet, let's replace the 
calls to create_ 
gui () in hfmix . 
pyw with these lines of 
code now. Just don't try 
to run it yet. 



This code uses an entirely new type of object, a whole new kind of 
widget that has never existed before. How do you tell the computer to create 
something like that, which is effectively a custom GUI object ? 



How do you convince the computer to create a new 
widget each time you call SoundPanelQ? 
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Wouldnt it be dreamy if there 
were a way in code to create an 
entirely new kind of widget. But 
I know it's just a fantasy... 
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A class is a machine for creating objects 

Object oriented programming (OOP) languages (like Python) let you create 
an entirely new kind of object using a class. A class is like a template that you 
use to create new objects. 

Think of the class like a cookie- cutter, and think of the object as the cookie 
that is created based on the class. As all the cookies are created from the same 
cookie cutter, they all have the same characteristics, even though they are 
all individual cookies. When an individual object is created from a class, it’s 
referred to as an instance of that class. 

So, if you can arrange for SoundPanelO to be a class, you can create 
custom widgets as required: 




You need code that creates a new grouped widget in the GUI every time you 
make a call like this: 

Use i he dlass b dreate a new okjedt 

panel = SoundPanel (app, mixer, "49119_M_RED_HardBouncer.wav") 

Let's define a SoundPanelO class. 
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A class has methods that define behavior 

The SoundPanel () class creates a new kind of tkinter Frame ( ) , and you 
can specify this relationship using the code like this: 




As well as the what (it’s a frame), you also have to worry about the how , which 
will define the behavior of your new widgets. To do this, you need to add 
methods inside the class. To understand how this works, imagine you have 
created an alarm button object from a class. The alarm button will need to 
know what to do when somebody hits it: 




necessary methods 



Solution 




You needed to create some methods for the new SoundPanel () 
class. You were asked to identify which of the following behaviors you 
thought you needed to create methods for: 



Someone moves the volume slid e n 




You've already dreaded 
even* t handlers that 
do something like this. 



Someone clicks the checkbox. 



3 



The computer starts up. 



You get to the end of the track. 



Create the interface. 




do you need 
do {o Create 
the interface? 



ijiereicire no 

Dumb Questions 




Why is there a method to create the widget? 




So you can't always see objects on the screen then? 



There isn't a method to create the widget. But there is a 
method to create the interface. That method will run immediately 
after the widget is created. 



Q I don't get it. What's the difference between a widget 
and an object? 



A widget is a particular type of object. It's an object that you 
can add to a graphical user interface. 




So there are some objects that are not widgets? 



Absolutely. Most objects are used behind the scenes in 
programs. All of the numbers and strings you've used so far have 
actually been objects. 



No, most objects run quietly in memory and they don't have 
any display at all. 




Is Python the only object oriented language? 



Lots of languages-such as J ava, C#, and Ruby-use 
objects to handle complexity. 



Q So learning object orientation is a 
into other languages? 



good way of getting 



Yes, understanding object orientation gives you a insight into 
how other languages think. 
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Put how does an object call a method? 

To see in more detail how the new SoundPanel widgets use the methods in 
the SoundPanel class, let’s look in more detail at just one of the methods. 
What happens if someone clicks on the checkbox within the widget? 



Hey, someone clicked 
the checkbox. The event 
handler for that is called 
"track_toggle". What happens 
now, SoundPanel class? 



Maurice 






¥ 



This is -the todt to the 

''tvatk^tooflleO" method- 

The method takes a 

£ single parameter- 



V 





def track_toggle (self ) : 

if self. track_playing . get ( ) 
self . track . play (loops 
else : 

self . track . stop ( ) 



The method you need to add to your class should look familiar. This code 
is almost the same as the track_toggle ( ) event handler we created 
before. The only difference is that this method is a little more selfish. 



scl-P idchti-pics the 
widget tailing the 
method. 



sejf identifies the widget calling the method 

The methods in the class are going to be used for lots of objects, so the code 
in the class needs some way to know which SoundPanel object it is working 
with at any point in time. It does that with the self variable. 

The self variable is passed to each of the methods in the class automatically 
by Python and it identifies the current widget object being used. By adding 
“self.” to the front of the object’s variable names in the class code, you 
make sure the code is using the data that belongs to the current widget. 



Let's add some methods to the SoundPanelO class... 
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The SoundPanel class looks a lot like the 
createjgoiO function 

If you convert the original change_volume ( ) function to a method and 
add it to the class, you end up with code that looks rather like the original 
create_gui() function: 



Most Jc this Lo&t looks 
very similar to tkc 

>0" m c\jnoA> 
e *Ce pt -Vov all -those uses 
of "self"- 




from tkinter import * 
import pygame . mixer 

class SoundPanel (Frame) : 

def track_toggle ( self ) : 

if self . track_playing . get ( ) == 1: 
self .track .play (loops = -1) 
else : 

self .track . stop ( ) 

def change_volume ( self ) : 

self .track . set_volume ( self . volume . get ( ) ) 



In fact, the new SoundPanel ( ) class can completely replace the code in 
the sound_panel . py file (as create_gui ( ) is no longer needed). 

But before you do that, there’s still a little more code to write. The class needs 
to be told what to do when the brand new SoundPanel ( ) is created. The 
class needs an initializer method that knows how to create instances of the 
class. 

Some pv-ogvanr.nr.mg languages tall -these 
initializer methods CONSTRUCTORS, because 
they detail what happens when a new object 
is cveated ov 'constructed-” 



Let's create the initializer for the SoundPanelQ class. 
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Code Magnets 

We've started to create the initializer code for you, but there are still a few 
parts missing. See if you can work out where the missing code fragments 
fit. Here is the code that creates a SoundPanel ( ) object. Position the 
code magnets properly to complete the method: 



def init (self, app, mixer, sound_file) : 



Frame . init (self. 




Bedause SoundPanel 0 inherit tom 
Winter's FVameO, you need to be sure 
t O initialize the Fra»eO BEFORE you 
initialize the SoundPanelO. 



track_button = Checkbutton ( 



, variable = 



command = self . track_toggle, text = sound_file) 

track_button . pack ( side = LEFT) 



self . volume . set (track . get_volume ( ) ) 

volume_scale = Scale ( , variable = self. volume, from_ =0.0, to = 1.0, 

resolution = 0.1, command = , 

label = "Volume", orient = HORIZONTAL) 
volume_scale . pack ( side = RIGHT) 
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Code Magnets Solution 

We've started to create the initializer code for you, but there are still a few 
parts missing. See if you can work out where the missing code fragments 
fit. Here is the code that creates a SoundPanel ( ) object. You were 
asked to position the code magnets properly to complete the method: 



def init (self, app, mixer, sound_file) : 

That's a douWc^/^ Frame. init (self, app) 

vAttdevstove at 

cVtheir »dc oV 

-the wov-d »*it • 




SoundPanelO 

object has its own -trade- 



Baeh SoundPanelO object has its 
own eheekbo*. 



track_button = Checkbutton ( self I f variable = I self. | track_j?laying I , 



command = self . track_toggle, text = sound_file) 



track_button . pack ( side = LEFT) 

self • 



volume = DoubleVar() 



] 



self . volume . set (track . get_vo lume ( ) ) 

volume_scale = Scale ( | self | r variable = self. volume, from_ = 0.0, to = 1.0, 

> 

UtV So^dPa^e' 0 y 

objett bas Vb •* sMtr 




resolution = 0.1, command = \ se ^ j I change^ 



volume 



label = "Volume", orient = HORIZONTAL) 
volume_scale . pack ( side = RIGHT) 



class s methods + data 

The SoundPanel () class has methods that define the behavior 
that it implements. In addition to the methods, the class also 
has to detail the data that it holds. For the SoundPanel ( ) 
class, this data is made up from three things: the track to play, 
its checkbox, and its associated slider. 
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The Class Exposed 

This week’s interview: 

Life in senior object management. 



Head First: Hello, Glass. It’s good of you to find 
the time to speak to us. 

Class: I assure you the inestimable pleasure is all 
mine. 

Head First: So, to begin... 

Class: One moment... <hums> 

Head First: I’m sorry. What’s that? 

Class: Apologies. Just checking my initializer. I 
always do it when I create. 

Head First: Ah, yes. That’s your constructor, isn’t 
it? The method you use to create objects? 

Class: Well, I’m aware that some people refer to it 
as a constructor , but I prefer initializer. I don’t use 
it to create objects, you see. I just use it to configure 
them once they’ve been created. 

Head First: You have a lot of methods? 

Class: Oh, more than you can possibly imagine. 

Head First: In the code we’ve just seen, the 
SoundPanel ( ) class, there were only three 
methods, weren’t there? 

Class: Oh, dear boy, there were only three methods 
defined explicitly in the class. But SoundPanel ( ) 
inherited many, many more methods from its parent 
class, dear old tkinter’s Frame ( ) . 



Head First: Frame ( ) has a lot of methods, too? 

Class: Too many to discuss, really. There are 
methods to paint components on the screen and 
details of what to do if things change size. Frame 
is a fearfully busy fellow. <beep beep> Excuse me. 
Hello? Yes? No, you need to stop playing track four. 
No, no, it’s quite all right. Goodbye. 

Head First: One of your objects? 

Class: Yes. They keep me very busy, but I’d miss 
them if they didn’t call. 

Head First: I believe when someone calls an object 
method, the object always asks you to get involved? 

Class: Yes. I’m in charge of the object’s behavior. I 
do think it is so important to behave properly. Don’t 
you? 

Head First: Of course! Glass, thank you. 

Class: Love the tie, by the way. 
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CoJe Review 

It’s always good every once in a while to check back on the state 
of your code and make sure everything’s looking spiffy. This is 
what your program should look like at this point. It’s probably 
worth checking to make sure everything in your code looks like 
this: 

hftnix.pyw 

— 

from tkinter import * 

from sound_panel import * 
import pygame. mixer 

app = Tk ( ) 

app . title ( "Head First Mix”) 
mixer = pygame. mixer 

mixer. init() Did Vou member -bo use WdPanelO instead of d<reate_> 0? I 

mixer, "50459_M_RED_Nephlimizer . wav" ) 
mixer, "49119_M_RED_HardBouncer .wav" ) 

panel . pack ( ) 

def shutdown ( ) : 
track . stop ( ) 
app . destroy ( ) 

app. protocol ( "WM_DELETE_WINDOW" , shutdown) 



app . mainloop ( ) 




panel = SoundPanel (app, 

panel . pack ( ) 

panel = SoundPanel (app. 
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soimcLpanel.py 



from tkinter import * 
import pygame. mixer 



An initials *ett«d tomes first Note that this ^hod ^ bt 
ta || e£ j « m ',-t 0" in Python in order -to be tailed automattally 

when "the objett is treated- 



class SoundPanel (Frame) : 

def init (self, app, mixer, sound_file) : 

Frame. init (self, app) 

self. track = mixer . Sound (sound_file) 
self . track_playing = IntVar() 

track_button = Checkbutton ( self , variable = self . track_playing, 

command = self . track_toggle, text = sound_file) 



track_button . pack ( side = LEFT) 
self. volume = DoubleVar() 

self . volume . set ( self .track . get_volume ( ) ) 

volume_scale = Scale (self, variable = self. volume, from_ = 0.0, to = 1.0, 

resolution = 0.1, command = self . change_volume, 
label = "Volume", orient = HORIZONTAL) 
volume_scale . pack ( side = RIGHT) 



def track_toggle ( self ) : 

if self . track_playing . get ( ) == 1: 
self . track . play ( loops = -1) 
else : 

self .track . stop ( ) 



def change_volume ( self , v) : 

self . track . set_volume ( self . volume . get ( ) ) 
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Tost DriVq 



OK, so you’re finally ready to start up your new custom widget code. This 
is what it looks like after you bring your code into IDLE and press F5: 









J- 



The checkboxes and volume scales are now grouped together on the 
same widget within the GUI. From now on, you will know that the 
widgets on your GUI will always stay together as the SoundPanel ( ) 
class has grouped them for you. 
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tfierejure no 

Dumb Questions 




I don't get it. What's this "self" thing again? 



"self" is a variable that refers to the calling object. 



O: 



The calling object? What does that mean? 



Imagine you create a new method called bleep ( ) in 
the SoundPanel class. An object called panel can use 
the bleep ( ) method as needed, and when it does, it calls the 
SoundPanel class. The "self." bit ensures that the bleep ( ) 
method associated with the panel object is called, not some 
other bleep ( ) method associated with some other object. 




So objects don't actually own their own methods? 



In some languages, such as Ruby, they can, but in most 
languages, no, objects don't own their own methods. The methods 
all belong to the class that created the object. 



Q/ But why do I need to add "self." to the start of the 
variables? 



Because then you are changing data inside the current 
object referred to by "self." You will be working with the object's 
own data, and not with data that belongs to the class. 



Not all the variables had "self." at the beginning. Why 
is that? 



If you look at the code, the volume_scale variable 
does not begin with "self.". That's because the object does not 
need to keep track of the volume_scale variable once the 
initializer method has finished creating the object. volume_ 
scale is a variable that is local to the initializer. 




BULLET POINTS 



■ The SoundPanel widget is a type of frame. 

■ Objects get created by classes. 

■ A class has methods. 

■ The methods define the behavior of the 
object. 

■ When an object needs to know what to do, 
it calls a method in the class that created it. 



The methods in the class all have a self 
variable. 

The seif variable points to the object 
that called the method. 

By prefixing variables with "self." you 
can keep each object's values separate 
from each other. 
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add the tracks 



The PJ has an entire directory of tracks 



The DJ is so impressed by how usable your program is that he wants to 
try it out tonight for his complete set, prior to its official unveiling at 
the World Music Mixing Expo. The DJ needs to work with a lot more than 
two tracks. In fact, he has an entire directory full of loops. 



PiV-Ct-boV-Y 
-full o£ loops. 

4 - 



stage*- read -all-files - Fite Manager 



file Edit View Go Help 



H 


C 3 banyp 


El Desktop 


inucsign 


HlTrog 


ebaptenu 


code 


:4\ 

4 Wftu i iun 


IHi 

IV | if VM f 


r 

UJAV 



t WftU 



19 1 47_M_RfD_b 
ccp_rinc.wav 



394 G4 M_RFD_ 

_trancc_mjjnpct 

_luup.wav 



19 E 07 

_mimpct_dclay 

loup.WdV 



41 ii? Mj\rn_9 
OTtar_Unc.wav 



4i7??_M_rarn_ 

_hoppYjrcaq.wa 




45414 _M_FtED_Tr 
ance Tram.wav 



49119 _M_RED_H 

ardBouncer.wav 



50459_M_RED_N 

eptili mizer.wav 



5 G 643 _M_RED_W 
ave Base Loop, wa 
v 



592 S 4 _M_RED_T 
heDreamOrums. 
wav 



l_ u L© 

dcmilsanriat hfmiscpyw snunripancl.py 

tribuUon.txt 



13 hems f 14.5 MB), Frccspocc: 4 .7 GB 



Now you could just change the code to add the extra files to the interface, 
but the DJ wants to be able to manage which tracks the program uses. 

So you will have to find all of the WAV files in the current directory and 
then add them to the interface when the program starts. 

Let's get this thing to work. 
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Paa] Puzz]e 



Your job is to take segments from the 
pool and place them into the blank 
lines in the code. You may not use 
the same segment more than once, 
and you won't need to use all the 
segments. Your goal is to complete 
the code in hfmix . pyw so that it 
reads all the tracks from the directory 
and then adds them to the GUI interface. 



from tkinter import * 
from sound_panel import * 
import pygame. mixer 
import os 



app = Tk ( ) 

app . title ( "Head First Mix") 



mixer = pygame. mixer 
mixer . init ( ) 



def shutdown ( ) : 

track . stop ( ) 

app . destroy ( ) 

app. protocol ( "WM_DELETE_WINDOW" , shutdown) 



Note: each thing from a PP ■ mainloo P < > 




tracks added 




Pool Puzz]e §®]ufion 

Your job was to take segments from the 
pool and place them into the blank 
lines in the code. You could not 
use the same segment more than 
once, and you didn't need to use 
all the segments. Your goal was to 
complete the code in hfmix . pyw 
so that it reads all the tracks from the 
directory and then adds them to the GUI 
interface. 



from tkinter import * 
from sound_panel import 
import pygame. mixer 
f . import os 



You »eed to talk to the 
operating system 
imPov-t the w os module- 

app = Tk ( ) 

app . title ( "Head First Mix") * 

$et the «a*»es of a" 

mixer = pygame. mixer the -files m the euvvent 

mixer . init ( ) directory- 

lake eafi-h o£ the dirList = os . listdir ( " . " ) 

-filenames- for fname in dirList : 

if fname . endswith ( " . wav" ) : 

a»d if it ends in ............. i P ane l ' “ ' i oun ^ ane H ap P/' ' f name )' 

panei . pack ( ) 

...tv-eate a rr def shutdown () : 

£oundPa*elO a*d add track . stop ( ) 

it to the $u|. app . destroy ( ) 

app. protocol ( "WM_DELETE_WINDOW " , shutdown) 
app . mainloop ( ) 
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Tesr Drii/s 



With the code in IDLE and all the sound files in the directory, press 
F5. You should see something that looks a lot more powerful than 
the simple two- track mixer you had before: 




h>J& 



Every single track from the directory now appears on the 
interface and can be individually controlled. The program looks 
like it finally does everything the DJ wants. But the real test will be 
how it performs at World Music Mixing Expo... 
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programming rocks the house 




party time! 



The mixer program brought the house down! 

The DJ took your program to the World Music Mixing Expo and rocked 



the house, with your name in lights! By using classes for the widgets and 
creating an object oriented program, you made your good program (and 
the DJ’s performance) great. 



% 



Object orientation is meant to help you create complex programs with 
very little code. A lot of languages use object orientation, and not just 
for graphical user interfaces. You can use objects to build web applications 
or simulators or games. Any time you need to write an advanced program 
but don’t want your code to turn into a tangled mess of spaghetti, object 
orientation can come to the rescue! 

Congratulations! 

You got to the end of the book! And what a great journey it’s been. You’ve 
ruled with control statements. You’ve powered-up your programs with 
modular code. You’ve made graphical user interfaces that sing and, finally, 
you took your coding skills to the next level with object orientation. 

Well done! 
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Your Programming Toolbox 

You've got Chapter 10 under your belt. 
Let's look back at what you've learned 
in this chapter: 



w es to tveaU Y * 

* ** a “to** 0 *'* r 

#+****** 

* Create 

son* ttos*- . . ,(Jt rntot ^ d ° 

* £o"-c b-S-JP “ 

*vMy' :s * rea 



Python Tools 

tKrt emU, Wld}fb lnd Mf fc 
the widgets together (grouped). 

* £b “ ; tw irfwA*, a ^ 

^I3ss aCTihi'tioh. 

f K -r ihi V? ' L ihe *** o( ihe 

that is tailed automatically on obiect 
Creation. J 

*r!f.“ r^° d f have a s ^ ial triable 

called self that is set to the Current 
object 

* MU-, -«K* fc ft, ^ a VJriaWe 

"'"ns * belongs to the Current object- 



Download at WoweBook.Com 



you are here ► 



383 



CHAPTER 10 




go forth and program 



Leaving town... 




It's been great having you here in Codeville! 



We’re sad to see you leave, but there’s nothing like taking what you’ve learned 
and putting it to use. You’re just beginning your programming journey and we’ve put you in the 
driving seat. We’re dying to hear how things go, so drop us a line at the Head First Labs web 
site, www.headfirstlabs.com, and let us know how programming is paying off for YOU! 
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The Top Ten Things 4- 
x (we didn't cover) 




You’ve come a long way. 

But learning how to program is an activity that never stops. The more you code, the more 
you’ll need to learn new ways to do certain things. You’ll need to master new tools and 
new techniques, too. There’s just not enough room in this book to show you everything 
you might possibly need to know. So, here’s our list of the top ten things we didn’t cover 
that you might want to learn more about next. 
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proper python 



*1: Poing things "The Python Way" 



Throughout this book, we have very stubbornly resisted writing 
code in the most correct Python Way. “That’s not how a Python 
programmer would do it,” was a familiar refrain heard from the 
Head First Programming technical reviewers. Without fail, and with the 
greatest of respect to our reviewers, we generally ignored this advice. 



You see, every programming language has its preferred, tried and 
true, agreed, and accepted way of doing certain things, collectively 
known as programming idioms. And Python is no exception. This is, 
of course, a very good thing, because the more programmers 
using a particular language who follow the standard way of doing 
something, the better. Except, that is, when writing a book like this: 
one designed from the get-go to teach programming concepts. 






There are times when the idiom, although very smart, can be hard 
to understand and even harder to explain. So, when we had a choice 
between showing you how to do something in a generic way over 
showing you how to do it the Python way, we nearly always chose 
the former approach over the latter. This has the effect of making 
some of the code in this book positively repulsive to hardened 
Python programmers, something that is of little concern to us, as 
this book isn’t for them (and they have lots of other books already). 

This book is for you: the reader who wants to learn how to program 
regardless of the programming language chosen. 

Having said all that, if you now want to learn more about The 
Python Way , start by scanning through the booklist and book reviews 
maintained on the main Python website: 

http:/ / wiki.python.org/ moin/PythonBooks 



Yes, that’s supposed 
-to be a« ° 



Z 7 

PyihoH guru. 



Learn lots about Python W 
Mark Lw-tz-'s dlassid, "Learning 
Python, Edition," whidh now 
t ovens Python 3> and previous 
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*l\ Using Python 1 

If you remember way back in the Readme, we stated we were 
using release 3 of Python in this book. Of course, there’s much 
more to Python that just release 3, as the previous version of the 
language, release 2, is still very, very popular. 

And rightly so. Python 2 has been around for nearly a decade 
and has an impressive collection of technologies built around it, 
including Google’s App Engine , the Django Web Framework , Zope’s 
Content Management System , and the Twisted Networking Libraries (to 
name just a few). 

Despite all the Python 2 goodness out there, we still went with 
release 3 for this book and our reasoning was very simple: better to 
go with the future than settle on the past. The good folks that bring the 
world Python have stated that Python 3 is where all the cool, new 
stuff will happen with the language. Release 2 has entered what’s 
known as bug-fix mode only : if something is found in 2 that is broken, 
it’ll be fixed, but no new features will be added. 

And here’s the good news: there’s not much difference between the 
code you’ve been writing for Python 3 and what you would write 
for release 2, should you find yourself in the position of needing to 
(perhaps as a result of needing to fix some existing Python 2 code or 
working with a technology that’s based on Python 2). 

Here are a few lines of Python 2 code that highlight some of the 
differences: 



i python 



,h p y too* \ the Vaw 
IS "inpu-fcO”. ' 



-Pund-tioh 
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java , c#, et al 



*3; Other programming languages 



When it comes to teaching programming concepts, there’s more 
than enough to cover without trying to cover multiple programming 
languages. 



We like Python and hope over the course of this book that you’ve 
grown to like Python, too. However, if you want to explore or need to 
learn another programming language, there’s lots of help out there. 
Simply going to your favorite search engine and typing in the name of 
your chosen programming language produces a torrent of sites offering 
to provide you with everything you need to know. 



Two modern languages that are important are Java and C#. And 
guess what? If you have to learn these technologies, Head First Labs has 
you covered. 



■ m YbSeM«<l 

t'd'iW 





Having completed this book, you can now pick up either of these books 
and confidently work your way through them. 

Of course, if you find yourself working in a Java or G# programming 
environment and missing Python, don’t despair. Two active projects 
within the Python Community integrate Python with the above 
programming languages and are well worth checking out (search on the 
project name to learn more): 



Run Python Code 
v/ithin the Java — 

V/iv*tual Machine- 



^ jython 



/ronPython 

3 



Wtv C# a*d m- 
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*4: Automated testing techniques 

And, no, before you ask, this has nothing to do with program-testing 
robots automatically testing your code for you (which, we agree, 
would be nice). 

Automated testing does have everything to do with trying to make 
sure, as far as possible, that your code is working properly. 

But, how is this possible? 

The truth is, it’s very hard to know for sure that your code is working 
perfectly 100% of the time. Programs and software systems are 
complex beasts. Over time, they grow, and it gets increasingly hard 
to know for sure if they are working quite the way you want them to. 

To help, programmers test their code. When they are done, they 
test, test, then test some more. And just to be sure, they test again. In 
fact, programmers often test to destruction , which refers to attempting 
everything they know to try and break the program and make it 
misbehave. If testing finds a problem, the code is then fixed so that 
whatever it was isn’t a problem anymore. 

To help with the grunt work that testing sometimes is, Python comes 
with a handy built-in module called unittest. This module’s sole 
purpose in life is to allow you to write code that tests your code. Trust us, 
this isn’t as strange as it sounds. The unittest module provides 
a framework within which you can exercise your code to ensure it’s 
working the way you want it to. 

The idea is simple enough: as you write your code, you write a 
little extra bit of code based on unittest to check that your new 
code is working properly. If the test works (that is, it successfully 
demonstrates that your code is OK), you are then in a position to 
automate the testing of your code by reusing your unittest code. 

For more details, check out the description of unittest in your 
favorite Python book or online in the official Python documentation. 

And now that you know about unittest, you have no excuse not 
to use it to test your code. 
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* 5 : debugging 



This is not as disgusting as it sounds. 

Debugging is related to testing. It is the process of dealing with 
errors that aren’t picked up during testing but, instead, blow up in 
your face when you run your code or — worse — blow up in the face 
of your user! 

Tracking down where a problem is can sometimes feel like a bit of 
an art form, but there are some tried and true techniques that can 
make things easier for you. Experience helps a lot. 



The problem is not with 
the hardware; it's with 
your program. You'll have 
to DEBUG your code. 



O 

0 




As mentioned at the top of the page: debugging is related to testing. 
Typically, you debug your code after it is up and running and 
(possibly) delivered to your user. You test your code as you write it 
and before you give your program to your users. The idea is that you 
only ever give a user your program when you’re happy it works the 
way you want it to. 



One of the most important things you can know about when it 
comes to debugging code is a thing called the debugger. This is 
a software tool that can be used by programmers to run code step 
by step or line by line. As the program runs, the debugger lets you 
watch what’s going on and then potentially see when something 
goes wrong. If you can work out where in your code the problem lies, 
it makes it easier to fix, and the debugger is designed to help you do 
just that. 

It is a rare programming technology indeed that comes without 
a debugger. Python’s is called pdb and it can be accessed from 
within IDLE and within the Python Shell. Check the Python online 
documentation for more information on pdb. 



To be honest, though, there are no hard and fast rules here, and a 
lot of programmers blur the line between debugging and testing, 
treating it all as one activity. 
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#6: Command-line execution 



Throughout the IOV 2 chapters of this book, you’ve consistently 
executed your code from within the IDLE programming 
environment. This has been great while developing and working 
on your code, but it’s probably not how you want your users to run 
your programs. It turns out there’s more than one way to do it 
when it comes to running your code. The method available to you 
(and your users) will vary depending on the operating system you’re 
using. 



0y\ Windows, en-ter -the 
u C*\Py-thon3l \pyihon 
Command -ioge-iher wiih -the 
name O' P -the program you 
wan-t -to e*e£u-te- 

Jb 




Your operating system might have a file association already in place 
that allows you to double-click on a Python program and have 
it execute for you. If this is the case, feel free to double-click to 
your heart’s content. If not, here’s how to start Python from the 
command line on the “big 3” operating systems. Let’s assume the 
program you’re running is called cof f ee_pos . py: 



$ python3 coffee_pos .py 



DONUT 
LATTE 
FILTER 
MUFFIN 
Quit 



Choose an option: |§ 
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down with oop 



* 7 : Ooops... we could've covered more OOP 



Chapter 10 introduced the important concept of classes , and throughout 
the book we’ve touched on objects in lots of different places. Doing justice 
to all the concepts of object oriented programming (OOP) would easily take 
an entire book all on its own. 



The bit of OOP covered in Chapter 10 relates to the concept of 
encapsulation. This is the process of bundling data with methods into 
prebuilt templates that can be used to create functionally identical objects of a 
certain type. 



Now... if your eyes glazed over reading that last line, don’t worry; you are 
as normal as the rest of us. OOP is full of terminology like this. As well 
as encapsulation, there’s inheritance and polymorphism, too. 

Discussing all the ins and outs of OOP is something that takes a little 
time and it is not something that we are going to try and do on just one 
page! 

That said, OOP really comes into its own when your programs get very 
large and turn into software systems. When systems start to scale 
(get really, really big), the importance of proper design takes center stage, 
and OOP can help here — big time. Again, there’s help from those lovely 
people at Head First Labs. 



Encapsulation?!? 
Polymorphism?!? 
Inheritance?!? 

Could they not have 
chosen such intimidating 
terms? 



O 



This kook assumes you already 
know a little bit about Java, 
so Consider reading Head 
First Java -first 
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*$: Algorithms 

There are plenty of great books that believe it’s impossible to learn 
about programming without also learning about algorithms. 

The word “algorithm” is used to describe a precise and established 
way of solving a particular problem in any programming language. 
It’s often useful to think of an algorithm as a recipe. 

In the good of days, it was certainly true that every programmer had 
to have a good grasp of algorithms in order to get anything of any 
worth done. But, luckily for you, this is no longer the case. 

Nowadays, with programming technologies such as Python (and 
Ruby, Perl, Java, and C#), this is less of an issue because modern 
programming languages just do so much for you. 

For instance, if you need to sort something in Python, you either 
call the sort ( ) method on a object or use the built-in sorted ( ) 
function, and the thing you are working with is duly sorted. You are 
probably less concerned (and rightly so) with how the sort actually 
occurred — that is, with the details of the algorithm used to sort your 
data. Was it the quicksort algorithm or the bubblesort ? Maybe it was 
timsort or something else entirely? Maybe you don’t care, because 
calling sort ( ) or using sorted ( ) orders your data in the way you 
desire and frees you to move onto some other problem that needs 
solving. 

You could take the time to write a really cool sort function and learn 
lots about algorithms in the process but, let’s face it, life is far too short. 

If you want to write your own programming language, you’ll need 
to learn lots about algorithms. If all you want to do is use an existing 
programming language (like Python), you can worry less about 
algorithms and more about writing code, which is precisely how it 
should be (in our opinion). 
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heavy lifting 



„ , Sca^V 

*9: Advance d programming topics 

A 

There are a bunch of advanced programming topics that were never likely to 
make it into a book like this. Here is a list of six such topics (all supported by 
Python 3). 

Threads are a programming technology that allows you to break your 
program into discrete coded chunks that can then be executed in parallel or 
concurrently Each chunk is known as a thread. Using threads can result in 
some beautiful coding designs, which can make the solving of a certain class 
of problem almost trivial. Under certain circumstances and restrictions, it is 
possible to have threads communicate with each other and share data, which, 
although possible, is hard to get right and can lead to some rather tricky 
and hard-to-track-down bugs. If you think you need threads, approach with 
extreme caution and be prepared to have your brain expanded in ways that you 
never thought possible. 

Recursion is a programming technique that allows you to create a function 
that is capable of calling itself in order to get its work done. There are certain 
types of mathematical problems that are well-suited to a recursive solution, 
but not much else. 

Metaprogramming refers to writing programs that can write other 
programs or manipulate themselves (sounds icky, and it can be). It is not for 
the faint of heart. 

Functional programming (typified by languages such as Lisp) is a 
technique that treats computation as a series of function calls that specify 
what is required of the program, as opposed to a procedural program, which 
details the steps that are required in order to solve a problem. 

Regular expressions are a technology that allows you to specify 
concisely what it is you are looking for in your data. Having written a 
regular expression (or regex), Python can then go and get it for you. Every 
programmer should know how to take advantage of regexes. The trouble is, 
they look so very strange at first that most coders recoil in disgust. This is a 
pity, as we think regexes are super cool and well-worth learning. 

Unicode is an industry standard that allows you to consistently represent 
and work with text written in most of the world’s languages or “writing 
systems.” If you are working with text originating from somewhere other 
than the place where they speak your language, then you’ll want to know a 
bit about the Unicode character encoding system. 

If you find yourself needing any of this stuff, best to start on the Internet and 
do some background reading on the topic before buying a book with your 
hard-earned cash. The Wikipedia entries for each of these six topics are 
good starting points. 
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*10: Other IPEs, shells, and text editors 

It might be hard for you to fathom, but there is life beyond IDLE. 
There’s life beyond the Python Shell, too. Both IDLE and the Python 
Shell are great learning tools, but sooner or later, you might find 
yourself wanting more. 

iPython is a bit like the Python Shell on steroids , and a lot of Python 
programmers swear by it. It has a lot of extra features over and 
above those in the normal shell that are designed to make the Python 
programmer’s life easier. It is well-worth looking into. 

When it comes to full-blown programming environments, there 
are many choices. Search the Internet for “Python IDE” to see a 
complete list. A few that come up more than most include: Komodo, 
Eclipse, and Eric. It’s worth taking a look at each, and then 
deciding if one of them (or something else entirely) is just right for 
you. 

IDLE and the Python Shell may satisfy your needs. But, if you are 
looking for more from your programming tool, there’s lots of choices 
out there. 

As for text editors... well, there are lots of choices, too. Some people 
prefer Emacs, while others prefer vi. The Head First Labs advice is to 
try out a few editors before picking the one that best suits your needs. 
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Symbols 

: (colon) 

in if/else branches, 22 
in index of string, 43 
in while loops, 29 

{} (curly brackets), creating hashes, 153 
= (equal sign), assignment operator, 4, 35 
== (equal sign, double), equal to operator, 4, 15 

!= (exclamation point, equal sign), not equal to operator, 
30 

0 (parentheses) 

in format strings, 182 
in function definition, 82 

% (percentage symbol), preceding format strings, 180-182 
. (period), in library function request, 69 
+ (plus sign), addition operator, 58 
# (pound sign), preceding comments, 95, 205 
> (right angle bracket), greater than operator, 62, 75 
[] (square brackets) 

creating arrays, 132, 134 
enclosing index of array, 132 
enclosing index of string, 42 
enclosing key for hash, 153 



appendQ method, arrays, 132, 144 
arguments (parameters), 96-98, 101, 111 
arrays (lists), 130-134, 144, 285 
adding items to, 138 
counting occurrences of values in, 1 38 
creating, 132, 134 
extending, 132, 138 
index (offset value) for, 132 
methods for, 138 
multi-dimensional arrays, 152 
removing items from, 138 
reversing order of, 138, 140 
searching, 138 
sorting, 136-140, 144 
askokcancel message boxes, 306 
askquestion message boxes, 306 
askretrycancel message boxes, 306 
askyesnocancel message boxes, 304, 306 
assignment 

of multiple values, 122-124 
of single values, 4, 35 
assignment operator (=), 4, 35 
associative arrays, (see hashes) 
automated testing, 389 



A 

abstraction, 93 
addition operator (+), 58 
algorithms, 393 



B 

Bates, Bert (Head First Java), 388 
Beighley, Lynn (Head First SQL), 170 
bloated code, 8 1 
books 
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Head First G# (Stellman, Greene), 388 
Head First Java (Sierra, Bates), 388 
Head First Object-Oriented Analysis & Design 
(McLaughlin, Pollice, West), 392 
Head First SQL (Beighley), 170 
Learning Python, 4th Edition (Lutz), 386 
brackets, curly ({}), creating hashes, 153, 175 
brackets, square ([]) 

creating arrays, 132, 134 
enclosing index of array, 132 
enclosing index of string, 42 
enclosing key for hash, 153 
branches, 14, 15-21, 24 
break statement, 255 
ButtonQ widget, 255 

connecting code to, 239-244, 245 
creating, 234-236 



c 

G# language 

compared to Python, 9 
learning, 388 
characters, (see strings) 

GheckbuttonQ widget, 331-335, 348 
classes, 366, 372-373, 383. (see also methods; objects) 
constructors for, 370-373, 383 
data for, 372 
defining, 367-368 
clockQ function, time library, 70 
closeQ method, hies, 116, 144 
code 

bloated, 81 



command-line execution of, 391 
comments in, 95, 205 
debugging, 390 
duplicating, 80-81 
indents in, 21, 22 
paths in, 13, 20-21 
pseudo-code, 127 
Python practices for, 386 
reusing with functions, 81-82, 351-360 
reusing with modules, 192-199, 200-202, 205-21 1, 
214 

running from IDLE, 7-8 
saving, 7 
testing, 389 
white space in, 22 
code examples, (see examples) 

coffee examples, (see health club example; Starbuzz Coffee 
example) 

collection variables, (see data structures) 
colon (:) 

in if/else branches, 22 
in index of string, 43 
in while loops, 29 
combo boxes, 248 
command-line execution, 391 
comments, 95, 205 
conditionals, 35 

in branches, 14-15 
in while loops, 29 

constructors (initializer methods), 370-373, 383 

control variables, 278 

controller, 277, 292 

count() method, arrays, 138 

crashes, 296 

curly brackets ({}), creating hashes, 153, 175 
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D 

data entry widgets 

Checkbutton0 widget, 331-335, 348 
EntryO widget, 261-262, 266-267, 269, 292 
model for, 276-278, 285, 292 
OptionMenuO widget, 284-290, 292 
populating dynamically, 288-290, 292 
RadioButtonO widget, 272-273, 275-280, 292 
restricting input to, 271-273 
ScaleO widget, 336-338, 340-345, 348 
TextO widget, 261, 263, 266-267, 269, 292 
data storage, 129-130 

data structures, 131, 150. (see also arrays; hashes) 
list of, 152 

returning from functions, 164-167 
database, 170-172, 175 
datatypes, converting, 4, 9, 64-65, 75 
date and time functions, 68-73 
daylightf) function, time library, 70 
debugging, 390 
decision points, (see branches) 
decode() method, 49 
def keyword, 82, 111 

delete() method, data entry widgets, 262, 263, 267, 269 
delivery company example, 258-291 
dynamic depot options for, 283-291 
errors in delivery tracking, handling, 294—3 1 0 
GUI for delivery system, 258-268 
user input, controlling, 271-281 
destroyO method, apps, 326, 348 
dialog boxes, 248. (see also message boxes) 
dictionaries, (see hashes) 
directories, reading hies in, 378-381 
disk storage, 129 



DJ example, (see mixing software example) 

Don’t Repeat Yourself (DRY), 88 

Double VarO variable, 340, 345, 348 

drop down lists, 248. (see also OptionMenuO widget) 

DRY (Don’t Repeat Yourself), 88 



E 

Eclipse IDE, 395 

editors, 5, 395. (see also IDLE) 

Emacs editor, 395 
encapsulation, 392 
endswithO method, strings, 56 
EntryO widget, 261, 269, 292 
creating, 266-267 
methods for, 262 

equal sign (=), assignment operator, 4 

equal sign, double (==), equal to operator, 4, 15 

Eric IDE, 395 

errors, 311. (see also debugging; testing) 
crashes resulting from, 296 
displayed in Shell instead of GUI, 295 
displaying in message boxes, 303-309 
exceptions, 296-300, 311 
TypeError message, 63—64 
ValueError message, 119-120 
event loop, 233-234, 255 
events 

handlers for, 239, 244-245, 255 
from operating system, 319, 348 
from Window Manager, 319-324, 326-327 
examples 

delivery company example, 258-291 
game show example, 216-254 
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guessing game, 3-34 
health club example, 1 7 8-2 1 3 
mixing software example, 314-347, 350-382 
Starbuzz Coffee, 38-74, 78-110 
storeroom example, 294-310 
Surf-A-Thon example, 114-143, 146-174 
except statement, 298-300, 311 
exceptions, 296-300, 311 

exclamation point, equal sign (!=), not equal to operator, 
30 

extendQ method, arrays, 138 



F 

false value, 1 4 
File menu 

New Window option, 6 
Save option, 7 

hies 

handles for, 116 
permissions for, 295 
reading all hies in directory, 378-381 
reading from, 116-118, 166 
hndQ method, strings, 56-58 
hoatQ function, 64-65, 118 
for loop, 116-118, 154-156 
format strings, 180-184, 186, 214 
formatted data, 179 

FQNs (fully qualihed names), 207-211, 213, 214 
FrameQ widget, 364, 373, 383 
fully qualihed names (FQNs), 207-211, 213, 214 
functional programming, 394 

functions, 82. (see also reusing code; specihc functions) 
calling, 82, 84 



creating (dehning), 82, 111 

local functions, 356-358, 383 

parameters for, 96-98, 101, 111 

returning data structures from, 164-167, 170-172 

returning values from, 87-88, 111 

with same name in different modules, 206-21 1,213 

scope of variables in, 104-108 



G 

game show example, 216-254 

answers, displaying in GUI, 246-254 
answers, sound effects for, 216-228 
answers, tallying, 216-218, 226-228 
GUI for, 230-245 
getQ method 

data entry widgets, 262, 263, 269, 278 
IntVarQ variable, 332, 334 
get_busy() method, channels, 22 1 
global variables, 108-109, 244 
gmtimeQ function, time library, 70 
graphical user interface, (see GUI) 
greater than operator (>), 62, 75 
Greene, Jennifer (Head First C#), 388 
grouping widgets, 363-364 
guessing game example, 3-34 

guesses, determining if correct, 3-8 
guesses, higher or lower hints for, 10—25 
multiple guesses, allowing, 26-34 

GUI (graphical user interface), 215, 230-232. (see also 
widgets) 

displaying messages in, 246-254, 303-309, 311 

errors not displayed in, 295 

event loop for, 233-234 

guidelines for, 34 1 

positioning widgets in, 235-238 
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H 

hash mark (#), preceding comments, 95, 205 
hashes (dictionaries), 152, 175 

adding data to, 153, 156, 161-162 

creating, 153, 175 

iterating through data, 154-156 

keys of, restrictions on, 156 

returning from functions, 164—167, 170—172 

sorting, 158 

Head First G# (Stellman, Greene), 388 
Head First Java (Sierra, Bates), 388 

Head First Object-Oriented Analysis & Design 
(McLaughlin, Pollice, West), 392 

Head First SQL (Beighley), 170 
health club example, 1 7 8-2 1 3 
hie format changes, 187-199 
multiple price discounts, 204-2 1 3 
price discount, 200-203 
transactions, recording in hie, 179-186 
Help menu, 22 
HTML, as strings, 49 

i 

IDE (Integrated Development Environment), 5, 9, 395 
IDLE, 5, 9, 22 

if/else branches, 4, 15-21, 24 
import statement, 49, 69 
importing 

libraries, 49, 69, 221, 226 
modules, 193, 199, 202,211,214 
indents in code, 21, 22 



index (offset value) 
for arrays, 132 
for strings, 42 

indexQ method, arrays, 138 
inheritance, 392 

init 0 method, 372, 375, 383 

initializer methods (constructors), 370-373, 383 
input() function, 4, 35, 387 
insert)) method 
arrays, 138 

data entry widgets, 262, 263, 269 
inQ function, 4, 9, 35 

Integrated Development Environment (IDE), 5, 9, 395 
internationalization, format strings for, 186 
interpreter, 5. (see also IDLE) 

IntVarO variable, 249, 253, 255 
iPython shell, 395 
IronPython project, 388 
itemsO method, hashes, 154, 175 
iteration, (see loops) 

J 

Java language 

compared to Python, 9 
learning, 388 
Jython project, 388 

K 

keysQ method, hashes, 154, 175 
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key-value lists, (see hashes) 

Komodo IDE, 395 

L 

Label() widget, 248-253, 255 
labels for values, (see variables) 

Learning Python, 4th Edition (Lutz), 386 
libraries, 75. (see also pygame library) 
importing, 49, 69, 221, 226 
third-party libraries (packages), 220, 223 
time library, 68-73 

tkinter library, 233-236, 238, 255, 341 
linked lists, 152 
listdirQ function, 380 
lists, (see arrays) 
local functions, 356-358, 383 
local variables, 105, 106, 111 
localtimeQ function, time library, 70 
loops, 28, 35 

delaying iterations of, 67-73 
event loop, 233-234, 255 
for loop, 116-118, 154-156 
while loop, 29-33, 61-65 
lower 0 method, strings, 56 
Lutz, Mark (Learning Python, 4th Edition), 386 



McLaughlin, Brett D. (Head Lirst Object-Oriented Analy- 
sis & Design), 392 

memory, 129-130 
menus, 248 

message boxes, 303-309, 311 
messages 

error messages, (see errors) 
protocol messages, 322 
sending to Twitter, 93-98, 101 
metaprogramming, 394 
methods, 377, 383. (see also specific methods) 
calling, 369-372 
defining, 367-368 

mixing software example, 314-347, 350-382 
multiple tracks, controlling, 350-376 
multiple tracks, reading from directory, 378-382 
toggle for starting and stopping, 328-335 
tracks, starting and stopping, 314-327 
volume control, 336-347 
model for data entry widgets, 276-278, 285, 292 
Model View Controller (MVC), 277 

modular code, 192-199, 200-202, 205-211, 214. (see also 
reusing code) 

module, (see code) 
multi-dimensional arrays, 152 
multiple assignment, 122-124 
MVC (Model View Controller), 277 



mainloopO method, tkinter, 234, 253 
mappings, (see hashes) 



N 

\n, newline in format strings, 182 
New Window option, Lile menu, 6 
not equal to operator (!=), 30 
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o 

object API, 292 

object-oriented languages, 368, 383 

object-oriented programming (OOP), 392 

objects, 366, 368, 377, 383. (see also classes; methods) 

offset value (index) of strings, 42 

OOP (object-oriented programming), 392 

openQ function, 116, 144 

OptionMenuO widget, 284—290, 292 

Options menu, 22 

ordered lists, (see also sorting data) 

P 

packQ method, tkinter, 235-236, 238, 264, 269 
packages (third-party libraries), 220, 223 
parameters for functions, 96-98, 101, 111 
parentheses (0) 

in format strings, 182 
in function definition, 82 
pass statement, 221, 255 
paths in code, 13, 20-21 
pdb debugger, 390 

percentage symbol (%), preceding format strings, 180-182 

period (.), in library function request, 69 

permissions for hies, 295 

playO method, sounds, 221 

plus sign (+), addition operator, 58 

point-of-sale (POS) system, 178. (see also health club 
example) 



Pollice, Gary (Head First Object-Oriented Analysis & 
Design), 392 

polymorphism, 392 
popQ method, arrays, 138 

POS (point-of-sale) system, 178. (see also health club 
example) 

pound sign (#), preceding comments, 95, 205 
print() function, 4, 35, 387 
program, (see code) 
programming idioms, 386 
protocol events, 321-322 
protocolQ method, apps, 322 
pseudo-code, 127 
.py hie extension, 7 
pygame library, 219-223, 229, 255 
downloading and installing, 220 
importing, 221, 226 
mixer object for, 221, 226 
platforms supported by, 219 
setting volume, 339 
Python, 9 

books about, 386 
command-line execution of, 391 
compared to Java and G#, 9 
integrated into other languages, 388 
programming idioms for, 386 
systems supporting, 9 
version 2 of, 387 
versions of, 9 
Python IDE. (see IDLE) 

Python Shell, 5 

errors displayed in, 295 
running code in, 8 
.pywhle extension, 237 
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Q. 

queues, 152 



R 

RadioButtonO widget, 272-273, 275-280, 292 

randintQ function, 33, 35 

raw_input() function, 387 

readQ method, 49 

reading from files, 116—118 

record, 179. (see also database) 

recursion, 394 

regex, 394 

Regional Surfing Association (RSA) example, 160-167 
regular expressions, 394 
removeO method, arrays, 138 
repeating pieces of code, (see loops) 
replace() method, strings, 56 
reserved words, 341, 348 
returnQ statement, 87-88, 111 
return values for functions, 87-88, 111 
reusing code, (see also functions) 
with functions, 81-82, 351-360 
with modules, 192-199, 200-202, 205-211, 214 
reverse() method, arrays, 138, 140, 144 
right angle bracket (>), greater than operator, 62, 75 
RSA (Regional Surfing Association) example, 160-167 
Run Module option, Run menu, 7 



S 

Save option, File menu, 7 
ScaleQ widget, 336-338, 340-345, 348 
scope of variables, 104-108, 111 
searching 

arrays, 138 
strings, 52-58 

self variable, 369-370, 377, 383 
setQ method 

data entry widgets, 278, 280 
IntVarQ variable, 249 
set_volume() method, pygame, 339 
sets, 152 

sharing code, (see reusing code) 

Shell, (see Python Shell) 
showerror message boxes, 306, 308 
showinfo message boxes, 304, 306 
showwarning message boxes, 306 
Sierra, Kathy (Head First Java), 388 
sleepO function, time library, 70, 72-73 
slider on a scale, (see ScaleQ widget) 
sortQ method, arrays, 138, 144 
sortedQ function, 158, 175 
sorting data, 128-129 
algorithms for, 393 
in any data structure, 158, 175 
in arrays, 136—140, 144 
sound 

pausing between playing, 221, 223 
playing, 221, 226-227 
pygame library for, 219-223, 229 
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starting and stopping, 3 1 6-3 1 7 
volume, adjusting, 336-345 
WAV files for, 221, 223 
source code, (see code) 
spaces, (see white space) 

splitQ method, strings, 121—124, 144, 161—162, 175 
SQL, 170. (see also database) 
square brackets ([]) 

creating arrays, 132, 134 
enclosing index of array, 132 
enclosing index of string, 42 
enclosing key for hash, 153 
stack, 104 

stack frame, 105, 1 1 1 
Starbuzz Coffee example, 38-74, 78-110 
coffee supplies, maintaining, 78-91 
discount price, finding in HTML, 50-59 
health club discounts, calculating, 204-213 
low price, checking for, 60—74 
order messages, sending to Twitter, 92-110 
price, extracting from HTML, 38-49 
startswithQ method, strings, 56 
Stellman, Andrew (Head First C#), 388 
storage of data, 129-130 
storeroom example, 294-310 
strings, 41-42, 48, 75 

ending substring, checking, 56 
formatting, 180—184, 186, 214 
lowercase, converting to, 56 
methods for, 55-56 
offset value (index) of, 42 
removing white space from, 56 
replacing substrings in, 56 
searching for substrings in, 52-58 
splitting at spaces, 121-124 
splitting at specified character, 161-162 



starting substring, checking, 56 
substrings of, 43-46, 48, 49 
uppercase, converting to, 54, 56 
web pages as, 49 

StringVarO variable, 278, 280, 292 
stripQ method, strings, 56 
substrings, 48 
length of, 49 

searching for, in strings, 52-58 
specifying, 43-46, 49 

Surf-A-Thon example, 114—143, 146-174 
highest score, calculating, 114-125 
names, matching to scores, 142-143, 146-157 
score data, extracting from database, 169-174 
score data, extracting from formatted hie, 160-167 
scores, sorting, 136-141, 158-159 
three highest scores, calculating, 126-135 

T 

tabs in code, 22 
testing, automated, 389 
text, (see strings) 
text boxes, 248 
Text() widget, 261, 269, 292 
creating, 266-267 
methods for, 263 

third-party libraries (packages), 220, 223 
threads, 394 

timeO function, time library, 70 
time library, 68-7 3 
timezoneQ function, time library, 70 
TkQ app, 234, 255 
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tkinter library, 233-236, 238, 255, 341 
toggle switch, (see GheckbuttonQ widget) 
transaction file, 179-184, 188-191 
true value, 1 4 

try statement, 298-300, 31 1 

TVN example, 169-174. (see also game show example) 
Twitter, sending messages to, 93-98, 101 
TypeError message, 63-64 
types, (see datatypes) 

u 

Unicode character encoding system, 394 
unittest module, 389 
upperQ method, strings, 54, 56 
uppercase, converting strings to, 54 
urllib.request library, 69 
urlopenQ function, 49 

V 

ValueError message, 119-120 
variables, 4, 35 

collections of. (see data structures) 
control variables, 278 
global variables, 108-109, 244 
local variables, 105, 106, 111 
scope of, 104-108, 1 1 1 
vi editor, 395 



view, 277. (see also widgets) 

visual toggle, (see GheckbuttonQ widget) 

volume, adjusting, 336-345 

w 

wait_hnish0 function, 221, 223 
WAV hies, 221, 223 
web pages, as strings, 49 

West, Dave (Head First Object-Oriented Analysis 
Design), 392 

while loop, 29-33, 61-65 
white space 
in code, 22 

removing from strings, 56 
specifying in format strings, 182 
splitting strings at, 121-124 
widgets 

ButtonO widget, 234-236, 239-244, 245, 255 

choosing, 341 

compared to objects, 368 

for data entry. ( see data entry widgets) 

event loop for, 255 

FrameO widget, 364, 373, 383 

grouping, 363-364 

LabelO widget, 248-253, 255 

list of, 248 

positioning, 235-238 
Window Manager, 348 
Window Manager events, 319-324, 326-327 
WM_D ELETE_WIND O W message, 322 
WM_SAVE_YOURSELF message, 322 
WM_TAKE_FOCUS message, 322 
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